├── .editorconfig
├── .eslintignore
├── .eslintrc
├── .gitignore
├── .travis.yml
├── AUTHORS.md
├── CHANGES.md
├── LICENSE
├── README.md
├── appveyor.yml
├── bin
    └── gitbook.js
├── gulpfile.js
├── lib
    ├── blocks.js
    ├── book.js
    ├── config_default.js
    ├── configuration.js
    ├── conrefs_loader.js
    ├── generator.js
    ├── generators
    │   ├── ebook.js
    │   ├── index.js
    │   ├── json.js
    │   └── website.js
    ├── index.js
    ├── init.js
    ├── plugin.js
    ├── pluginslist.js
    ├── template.js
    ├── utils
    │   ├── batch.js
    │   ├── fs.js
    │   ├── git.js
    │   ├── i18n.js
    │   ├── images.js
    │   ├── links.js
    │   ├── logger.js
    │   ├── navigation.js
    │   ├── page.js
    │   ├── path.js
    │   ├── progress.js
    │   ├── server.js
    │   ├── string.js
    │   └── watch.js
    └── version.js
├── package.json
├── preview.png
├── test
    ├── assertions.js
    ├── books
    │   ├── basic
    │   │   ├── README.md
    │   │   └── SUMMARY.md
    │   ├── config-js
    │   │   ├── README.md
    │   │   ├── SUMMARY.md
    │   │   └── book.js
    │   ├── config-json
    │   │   ├── README.md
    │   │   ├── SUMMARY.md
    │   │   └── book.json
    │   ├── conrefs
    │   │   ├── README.md
    │   │   ├── SUMMARY.md
    │   │   ├── block.md
    │   │   └── hello.md
    │   ├── glossary
    │   │   ├── GLOSSARY.md
    │   │   ├── README.md
    │   │   ├── SUMMARY.md
    │   │   └── folder
    │   │   │   └── PAGE.md
    │   ├── headings
    │   │   ├── README.md
    │   │   └── SUMMARY.md
    │   ├── highlight
    │   │   ├── README.md
    │   │   └── SUMMARY.md
    │   ├── images
    │   │   ├── README.md
    │   │   ├── SUMMARY.md
    │   │   ├── folder
    │   │   │   └── PAGE.md
    │   │   └── test.svg
    │   ├── init
    │   │   ├── .gitignore
    │   │   └── SUMMARY.md
    │   ├── languages
    │   │   ├── LANGS.md
    │   │   ├── README.md
    │   │   ├── en
    │   │   │   ├── README.md
    │   │   │   └── SUMMARY.md
    │   │   └── fr
    │   │   │   ├── README.md
    │   │   │   └── SUMMARY.md
    │   ├── links
    │   │   ├── README.md
    │   │   ├── SUMMARY.md
    │   │   ├── folder1
    │   │   │   └── README.md
    │   │   └── folder2
    │   │   │   └── README.md
    │   ├── structure
    │   │   ├── README.adoc
    │   │   ├── README.md
    │   │   ├── SUMMARY.md
    │   │   ├── book.json
    │   │   └── glossary.md
    │   ├── style-print
    │   │   ├── README.md
    │   │   ├── SUMMARY.md
    │   │   └── styles
    │   │   │   └── print.css
    │   └── summary
    │   │   ├── PAGE1.md
    │   │   ├── README.md
    │   │   ├── SUMMARY.md
    │   │   └── folder
    │   │       └── PAGE2.md
    ├── codehighlighting.js
    ├── configuration.js
    ├── conrefs.js
    ├── ebook.js
    ├── format.js
    ├── git.js
    ├── glossary.js
    ├── heading.js
    ├── helper.js
    ├── images.js
    ├── init.js
    ├── json.js
    ├── languages.js
    ├── links.js
    ├── navigation.js
    ├── plugins.js
    ├── plugins
    │   ├── blocks
    │   │   ├── index.js
    │   │   └── package.json
    │   ├── config
    │   │   ├── index.js
    │   │   └── package.json
    │   ├── empty
    │   │   ├── index.js
    │   │   └── package.json
    │   ├── filters
    │   │   ├── index.js
    │   │   └── package.json
    │   ├── invalid
    │   │   ├── index.js
    │   │   └── package.json
    │   ├── replace_highlight
    │   │   ├── index.js
    │   │   └── package.json
    │   └── resources
    │   │   ├── index.js
    │   │   └── package.json
    ├── resolve.js
    ├── structure.js
    ├── summary.js
    ├── templating.js
    └── website.js
└── theme
    ├── assets
        ├── ebook
        │   ├── ebook.css
        │   ├── epub.css
        │   ├── mobi.css
        │   └── pdf.css
        └── website
        │   ├── app.js
        │   ├── fonts
        │       └── fontawesome
        │       │   ├── FontAwesome.otf
        │       │   ├── fontawesome-webfont.eot
        │       │   ├── fontawesome-webfont.svg
        │       │   ├── fontawesome-webfont.ttf
        │       │   └── fontawesome-webfont.woff
        │   ├── images
        │       ├── apple-touch-icon-precomposed-152.png
        │       └── favicon.ico
        │   └── style.css
    ├── i18n
        ├── ar.json
        ├── bn.json
        ├── cs.json
        ├── de.json
        ├── en.json
        ├── es.json
        ├── fa.json
        ├── fi.json
        ├── fr.json
        ├── he.json
        ├── it.json
        ├── ja.json
        ├── ko.json
        ├── no.json
        ├── pl.json
        ├── pt.json
        ├── ro.json
        ├── ru.json
        ├── sv.json
        ├── uk.json
        ├── vi.json
        ├── zh-hans.json
        └── zh-tw.json
    ├── javascript
        ├── dropdown.js
        ├── events.js
        ├── index.js
        ├── keyboard.js
        ├── loading.js
        ├── navigation.js
        ├── platform.js
        ├── sidebar.js
        ├── state.js
        ├── storage.js
        └── toolbar.js
    ├── stylesheets
        ├── base
        │   ├── mixins.less
        │   ├── normalize.less
        │   └── preboot.less
        ├── ebook.less
        ├── ebook
        │   ├── base.less
        │   ├── glossary.less
        │   ├── summary.less
        │   └── variables.less
        ├── epub.less
        ├── mobi.less
        ├── pdf.less
        ├── website.less
        └── website
        │   ├── alerts.less
        │   ├── body.less
        │   ├── buttons.less
        │   ├── dropdown.less
        │   ├── glossary.less
        │   ├── header.less
        │   ├── languages.less
        │   ├── markup.less
        │   ├── navigation.less
        │   ├── summary.less
        │   └── variables.less
    └── templates
        ├── ebook
            ├── footer.html
            ├── glossary.html
            ├── header.html
            ├── layout.html
            ├── page.html
            └── summary.html
        └── website
            ├── glossary.html
            ├── includes
                ├── header.html
                └── summary.html
            ├── langs.html
            ├── layout.html
            └── page.html


/.editorconfig:
--------------------------------------------------------------------------------
 1 | # editorconfig.org
 2 | root = true
 3 | 
 4 | [*]
 5 | indent_style = space
 6 | indent_size = 4
 7 | end_of_line = lf
 8 | charset = utf-8
 9 | trim_trailing_whitespace = true
10 | insert_final_newline = true
11 | 


--------------------------------------------------------------------------------
/.eslintignore:
--------------------------------------------------------------------------------
1 | theme/**/*
2 | 


--------------------------------------------------------------------------------
/.eslintrc:
--------------------------------------------------------------------------------
 1 | {
 2 |     "rules": {
 3 |         "indent": [ 2, 4 ],
 4 |         "quotes": [ 2, "single" ],
 5 |         "linebreak-style": [ 2, "unix" ],
 6 |         "semi": [ 2, "always" ],
 7 |         "no-unused-vars": [ 2, {
 8 |             "vars": "all",
 9 |             "args": "none"
10 |         } ],
11 |         "spaced-comment": [ 2, "always" ]
12 |     },
13 |     "env": {
14 |         "node": true,
15 |         "mocha": true,
16 |         "browser": true
17 |     },
18 |     "extends": "eslint:recommended"
19 | }


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
 1 | # Logs
 2 | logs
 3 | *.log
 4 | 
 5 | # Runtime data
 6 | pids
 7 | *.pid
 8 | *.seed
 9 | 
10 | # Directory for instrumented libs generated by jscoverage/JSCover
11 | lib-cov
12 | 
13 | # Coverage directory used by tools like istanbul
14 | coverage
15 | 
16 | # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
17 | .grunt
18 | 
19 | # Compiled binary addons (http://nodejs.org/api/addons.html)
20 | build/Release
21 | 
22 | # Dependency directory
23 | # Deployed apps should consider commenting this line out:
24 | # see https://npmjs.org/doc/faq.html#Should-I-check-my-node_modules-folder-into-git
25 | node_modules
26 | 
27 | # vim swapfile
28 | *.swp
29 | 


--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
1 | sudo: false
2 | language: node_js
3 | node_js:
4 |   - "stable"
5 |   - "4.1"
6 |   - "0.12"
7 | before_install:
8 |   - npm install svgexport -g
9 | 


--------------------------------------------------------------------------------
/AUTHORS.md:
--------------------------------------------------------------------------------
 1 | Authors
 2 | =======
 3 | 
 4 | Also see https://github.com/GitbookIO/gitbook/graphs/contributors.
 5 | Names below are ordered by first contribution.
 6 | 
 7 | Author
 8 | ------
 9 | 
10 | - Samy Pessé <samypesse@gmail.com> (@SamyPesse)
11 | - Aaron O'Mullan <aaron.omullan@gmail.com> (@AaronO)
12 | 
13 | 
14 | Contributors
15 | ------------
16 | 
17 | - Nijiko Yonskai (@Nijikokun)
18 | - Herman Starikov (@Hermanya)
19 | 
20 | Translators
21 | ------------
22 | 
23 | - German
24 |     - Winnie (@winniehell)
25 | - Italian
26 |     - Giulio Bonanome (@gbonanome)
27 | - Russian
28 |     - Andrey Akinshin (@AndreyAkinshin)
29 | - Norwegian
30 |     - Knut Melvær (@kmelve)
31 | - Persian (Farsi)
32 |     - Mohammad Hossein Mojtahedi (@mhm5000)
33 | - Polish
34 |     - Łukasz Szeremeta (@lszeremeta)
35 | - Portuguese
36 |     - Ryan O'Mullan (@RyanOM)
37 | - Spanish
38 |     - Ryan O'Mullan (@RyanOM)
39 | - Simplifiled Chinese
40 |     - Hu Hao (@howiehu)
41 | - Traditional Chinese
42 |     - Hu Hao (@howiehu)
43 | - French
44 |     - Samy Pessé (@SamyPesse)
45 | - Romanian
46 |         - Iancu Aurel (@awrelll)
47 | - Finnish
48 |     - Tommi Savikko (@savikko)
49 | - Japanese
50 |     - Iancu Aurel (@awrelll)
51 | - Korean
52 |     - Iancu Aurel (@awrelll)
53 |     - SangYeob Yu (@deminoth)
54 | - Vietnamese
55 |     - Hong Nguyen (@nghong)
56 | - Hebrew
57 |     - @a-moses
58 | - Ukrainian
59 |     - @Karnaukhov
60 | - Czech
61 |     - @mjanda
62 | - Swedish
63 |     - Jacob Burenstam (@buren)
64 | 


--------------------------------------------------------------------------------
/appveyor.yml:
--------------------------------------------------------------------------------
 1 | # Fix line endings in Windows. (runs before repo cloning)
 2 | init:
 3 |   - git config --global core.autocrlf input
 4 | 
 5 | # Test against these versions of Node.js.
 6 | environment:
 7 |   matrix:
 8 |     - nodejs_version: "0.12"
 9 |     - nodejs_version: "4.1"
10 | 
11 | # Install scripts. (runs after repo cloning)
12 | install:
13 |   # Get the latest stable version of Node.js or io.js
14 |   - ps: Install-Product node $env:nodejs_version
15 |   # install svgexport
16 |   - npm install svgexport -g
17 |   # install modules
18 |   - npm install
19 | 
20 | # Post-install test scripts.
21 | test_script:
22 |   # Output useful info for debugging.
23 |   - node --version
24 |   - npm --version
25 |   # run tests
26 |   - npm test
27 | 
28 | # Don't actually build.
29 | build: off
30 | 


--------------------------------------------------------------------------------
/bin/gitbook.js:
--------------------------------------------------------------------------------
1 | #! /usr/bin/env node
2 | 
3 | var color = require('bash-color');
4 | 
5 | console.log(color.red('You need to install "gitbook-cli" to have access to the gitbook command anywhere on your system.'));
6 | console.log(color.red('If you\'ve installed this package globally, you need to uninstall it.'));
7 | console.log(color.red('>> Run "npm uninstall -g gitbook" then "npm install -g gitbook-cli"'));
8 | 


--------------------------------------------------------------------------------
/gulpfile.js:
--------------------------------------------------------------------------------
 1 | var _ = require('lodash');
 2 | var gulp = require('gulp');
 3 | var gutil = require('gulp-util');
 4 | var less = require('gulp-less');
 5 | var rename = require('gulp-rename');
 6 | var minifyCSS = require('gulp-minify-css');
 7 | var browserify = require('browserify');
 8 | var mergeStream = require('merge-stream');
 9 | var source = require('vinyl-source-stream');
10 | 
11 | gulp.task('css', function() {
12 |     var merged = mergeStream();
13 | 
14 |     _.each({
15 |         'ebook.less': 'ebook/ebook.css',
16 |         'pdf.less': 'ebook/pdf.css',
17 |         'mobi.less': 'ebook/mobi.css',
18 |         'epub.less': 'ebook/epub.css',
19 |         'website.less': 'website/style.css'
20 |     }, function(out, input) {
21 |         gutil.log('compiling', input, 'into', out);
22 |         merged.add(gulp.src('theme/stylesheets/'+input)
23 |             .pipe(less())
24 |             .pipe(minifyCSS())
25 |             .pipe(rename(out))
26 |             .pipe(gulp.dest('theme/assets/')));
27 |     });
28 | 
29 |     return merged;
30 | });
31 | 
32 | gulp.task('js', function() {
33 |     return browserify('./theme/javascript/index.js')
34 |         .bundle()
35 |         .pipe(source('app.js'))
36 |         .pipe(gulp.dest('./theme/assets/website'));
37 | });
38 | 
39 | gulp.task('assets', function() {
40 |     return gulp.src('./node_modules/font-awesome/fonts/*')
41 |     .pipe(gulp.dest('theme/assets/website/fonts/fontawesome/'));
42 | });
43 | 
44 | gulp.task('default', ['css', 'js', 'assets'], function() {
45 | 
46 | });
47 | 
48 | 


--------------------------------------------------------------------------------
/lib/blocks.js:
--------------------------------------------------------------------------------
 1 | var _ = require('lodash');
 2 | 
 3 | module.exports = {
 4 |     // Return non-parsed html
 5 |     // since blocks are by default non-parsable, a simple identity method works fine
 6 |     html: _.identity,
 7 | 
 8 |     // Highlight a code block
 9 |     // This block can be extent by plugins
10 |     code: _.identity
11 | };
12 | 


--------------------------------------------------------------------------------
/lib/config_default.js:
--------------------------------------------------------------------------------
  1 | var path = require('path');
  2 | 
  3 | module.exports = {
  4 |     // Options that can't be extend
  5 |     'configFile': 'book',
  6 |     'generator': 'website',
  7 |     'extension': null,
  8 | 
  9 |     // Book metadats (somes are extracted from the README by default)
 10 |     'title': null,
 11 |     'description': null,
 12 |     'isbn': null,
 13 |     'language': 'en',
 14 |     'direction': null,
 15 |     'author': null,
 16 | 
 17 |     // version of gitbook to use
 18 |     'gitbook': '*',
 19 | 
 20 |     // Structure
 21 |     'structure': {
 22 |         'langs': 'LANGS.md',
 23 |         'readme': 'README.md',
 24 |         'glossary': 'GLOSSARY.md',
 25 |         'summary': 'SUMMARY.md'
 26 |     },
 27 | 
 28 |     // CSS Styles
 29 |     'styles': {
 30 |         'website': 'styles/website.css',
 31 |         'print': 'styles/print.css',
 32 |         'ebook': 'styles/ebook.css',
 33 |         'pdf': 'styles/pdf.css',
 34 |         'mobi': 'styles/mobi.css',
 35 |         'epub': 'styles/epub.css'
 36 |     },
 37 | 
 38 |     // Plugins list, can contain '-name' for removing default plugins
 39 |     'plugins': [],
 40 | 
 41 |     // Global configuration for plugins
 42 |     'pluginsConfig': {},
 43 | 
 44 |     // Variables for templating
 45 |     'variables': {},
 46 | 
 47 |     // Set another theme with your own layout
 48 |     // It's recommended to use plugins or add more options for default theme, though
 49 |     // See https://github.com/GitbookIO/gitbook/issues/209
 50 |     'theme': path.resolve(__dirname, '../theme'),
 51 | 
 52 |     // Links in template (null: default, false: remove, string: new value)
 53 |     'links': {
 54 |         // Custom links at top of sidebar
 55 |         'sidebar': {
 56 |             // 'Custom link name': 'https://customlink.com'
 57 |         },
 58 | 
 59 |         // Sharing links
 60 |         'sharing': {
 61 |             'google': null,
 62 |             'facebook': null,
 63 |             'twitter': null,
 64 |             'weibo': null,
 65 |             'all': null
 66 |         }
 67 |     },
 68 | 
 69 | 
 70 |     // Options for PDF generation
 71 |     'pdf': {
 72 |         // Add toc at the end of the file
 73 |         'toc': true,
 74 | 
 75 |         // Add page numbers to the bottom of every page
 76 |         'pageNumbers': false,
 77 | 
 78 |         // Font for the file content
 79 |         'fontSize': 12,
 80 |         'fontFamily': 'Arial',
 81 | 
 82 |         // Paper size for the pdf
 83 |         // Choices are [u’a0’, u’a1’, u’a2’, u’a3’, u’a4’, u’a5’, u’a6’, u’b0’, u’b1’, u’b2’, u’b3’, u’b4’, u’b5’, u’b6’, u’legal’, u’letter’]
 84 |         'paperSize': 'a4',
 85 | 
 86 |         // How to mark detected chapters.
 87 |         // Choices are “pagebreak”, “rule”, 'both' or “none”.
 88 |         'chapterMark' : 'pagebreak',
 89 | 
 90 |         // An XPath expression. Page breaks are inserted before the specified elements.
 91 |         // To disable use the expression: '/'
 92 |         'pageBreaksBefore': '/',
 93 | 
 94 |         // Margin (in pts)
 95 |         // Note: 72 pts equals 1 inch
 96 |         'margin': {
 97 |             'right': 62,
 98 |             'left': 62,
 99 |             'top': 56,
100 |             'bottom': 56
101 |         },
102 | 
103 |         // Header HTML template. Available variables: _PAGENUM_, _TITLE_, _AUTHOR_ and _SECTION_.
104 |         'headerTemplate': null,
105 | 
106 |         // Footer HTML template. Available variables: _PAGENUM_, _TITLE_, _AUTHOR_ and _SECTION_.
107 |         'footerTemplate': null
108 |     }
109 | };
110 | 


--------------------------------------------------------------------------------
/lib/conrefs_loader.js:
--------------------------------------------------------------------------------
 1 | var _ = require('lodash');
 2 | var path = require('path');
 3 | var nunjucks = require('nunjucks');
 4 | 
 5 | var git = require('./utils/git');
 6 | var fs = require('./utils/fs');
 7 | var pathUtil = require('./utils/path');
 8 | 
 9 | // The loader should handle relative and git url
10 | var BookLoader = nunjucks.Loader.extend({
11 |     async: true,
12 | 
13 |     init: function(book, opts) {
14 |         this.opts = _.defaults(opts || {}, {
15 |             interpolate: _.identity
16 |         });
17 |         this.book = book;
18 |     },
19 | 
20 |     getSource: function(fileurl, callback) {
21 |         var that = this;
22 | 
23 |         git.resolveFile(fileurl)
24 |         .then(function(filepath) {
25 |             // Is local file
26 |             if (!filepath) filepath = path.resolve(fileurl);
27 |             else that.book.log.debug.ln('resolve from git', fileurl, 'to', filepath);
28 | 
29 |             //  Read file from absolute path
30 |             return fs.readFile(filepath)
31 |             .then(function(source) {
32 |                 return that.opts.interpolate(filepath, source.toString());
33 |             })
34 |             .then(function(source) {
35 |                 return {
36 |                     src: source,
37 |                     path: filepath,
38 | 
39 |                     // We disable cache sincde content is modified (shortcuts, ...)
40 |                     noCache: true
41 |                 };
42 |             });
43 |         })
44 |         .nodeify(callback);
45 |     },
46 | 
47 |     resolve: function(from, to) {
48 |         // If origin is in the book, we enforce result file to be in the book
49 |         if (this.book.fileIsInBook(from)) {
50 |             return this.book.resolve(
51 |                 this.book.relative(path.dirname(from)),
52 |                 to
53 |             );
54 |         }
55 | 
56 |         // If origin is in a git repository, we resolve file in the git repository
57 |         var gitRoot = git.resolveRoot(from);
58 |         if (gitRoot) {
59 |             return pathUtil.resolveInRoot(gitRoot, to);
60 |         }
61 | 
62 |         // If origin is not in the book (include from a git content ref)
63 |         return path.resolve(path.dirname(from), to);
64 |     },
65 | 
66 |     // Handle all files as relative, so that nunjucks pass responsability to 'resolve'
67 |     // Only git urls are considered as absolute
68 |     isRelative: function(filename) {
69 |         return !git.checkUrl(filename);
70 |     }
71 | });
72 | 
73 | module.exports = BookLoader;
74 | 


--------------------------------------------------------------------------------
/lib/generator.js:
--------------------------------------------------------------------------------
 1 | var _ = require('lodash');
 2 | var path = require('path');
 3 | var Q = require('q');
 4 | var fs = require('./utils/fs');
 5 | 
 6 | var BaseGenerator = function(book) {
 7 |     this.book = book;
 8 | 
 9 |     Object.defineProperty(this, 'options', {
10 |         get: function () {
11 |             return this.book.options;
12 |         }
13 |     });
14 | 
15 |     _.bindAll(this);
16 | };
17 | 
18 | BaseGenerator.prototype.callHook = function(name, data) {
19 |     return this.book.callHook(name, data);
20 | };
21 | 
22 | // Prepare the genertor
23 | BaseGenerator.prototype.prepare = function() {
24 |     var that = this;
25 | 
26 |     return that.callHook('init');
27 | };
28 | 
29 | // Write a parsed file to the output
30 | BaseGenerator.prototype.convertFile = function(input) {
31 |     return Q.reject(new Error('Could not convert '+input));
32 | };
33 | 
34 | // Copy file to the output (non parsable)
35 | BaseGenerator.prototype.transferFile = function(input) {
36 |     return fs.copy(
37 |         this.book.resolve(input),
38 |         path.join(this.options.output, input)
39 |     );
40 | };
41 | 
42 | // Copy a folder to the output
43 | BaseGenerator.prototype.transferFolder = function(input) {
44 |     return fs.mkdirp(
45 |         path.join(this.book.options.output, input)
46 |     );
47 | };
48 | 
49 | // Copy the cover picture
50 | BaseGenerator.prototype.copyCover = function() {
51 |     var that = this;
52 | 
53 |     return Q.all([
54 |         fs.copy(that.book.resolve('cover.jpg'), path.join(that.options.output, 'cover.jpg')),
55 |         fs.copy(that.book.resolve('cover_small.jpg'), path.join(that.options.output, 'cover_small.jpg'))
56 |     ])
57 |     .fail(function() {
58 |         // If orignaly from multi-lang, try copy from parent
59 |         if (!that.book.isSubBook()) return;
60 | 
61 |         return Q.all([
62 |             fs.copy(path.join(that.book.parentRoot(), 'cover.jpg'), path.join(that.options.output, 'cover.jpg')),
63 |             fs.copy(path.join(that.book.parentRoot(), 'cover_small.jpg'), path.join(that.options.output, 'cover_small.jpg'))
64 |         ]);
65 |     })
66 |     .fail(function() {
67 |         return Q();
68 |     });
69 | };
70 | 
71 | // At teh end of the generation
72 | BaseGenerator.prototype.finish = function() {
73 |     return Q.reject(new Error('Could not finish generation'));
74 | };
75 | 
76 | module.exports = BaseGenerator;
77 | 


--------------------------------------------------------------------------------
/lib/generators/ebook.js:
--------------------------------------------------------------------------------
  1 | var util = require('util');
  2 | var path = require('path');
  3 | var Q = require('q');
  4 | var _ = require('lodash');
  5 | var juice = require('juice');
  6 | var exec = require('child_process').exec;
  7 | 
  8 | var fs = require('../utils/fs');
  9 | var stringUtils = require('../utils/string');
 10 | var BaseGenerator = require('./website');
 11 | 
 12 | var Generator = function(book, format) {
 13 |     BaseGenerator.apply(this, arguments);
 14 | 
 15 |     // eBook format
 16 |     this.ebookFormat = format;
 17 | 
 18 |     // Resources namespace
 19 |     this.namespace = 'ebook';
 20 | 
 21 |     // Styles to use
 22 |     this.styles = _.compact(['print', 'ebook', this.ebookFormat]);
 23 | 
 24 |     // Convert images (svg -> png)
 25 |     this.convertImages = true;
 26 | };
 27 | util.inherits(Generator, BaseGenerator);
 28 | 
 29 | Generator.prototype.prepareTemplates = function() {
 30 |     this.templates.page = this.book.plugins.template('ebook:page') || path.resolve(this.options.theme, 'templates/ebook/page.html');
 31 |     this.templates.summary = this.book.plugins.template('ebook:summary') || path.resolve(this.options.theme, 'templates/ebook/summary.html');
 32 |     this.templates.glossary = this.book.plugins.template('ebook:glossary') || path.resolve(this.options.theme, 'templates/ebook/glossary.html');
 33 | 
 34 |     return Q();
 35 | };
 36 | 
 37 | // Generate table of contents
 38 | Generator.prototype.writeSummary = function() {
 39 |     var that = this;
 40 | 
 41 |     that.book.log.info.ln('write SUMMARY.html');
 42 |     return this._writeTemplate(this.templates.summary, {}, path.join(this.options.output, 'SUMMARY.html'));
 43 | };
 44 | 
 45 | // Return template for footer/header with inlined css
 46 | Generator.prototype.getPDFTemplate = function(id) {
 47 |     var tpl = this.options.pdf[id+'Template'];
 48 |     var defaultTpl = path.resolve(this.options.theme, 'templates/ebook/'+id+'.html');
 49 |     var defaultCSS = path.resolve(this.options.theme, 'assets/ebook/pdf.css');
 50 | 
 51 |     // Default template from theme
 52 |     if (!tpl && fs.existsSync(defaultTpl)) {
 53 |         tpl = fs.readFileSync(defaultTpl, { encoding: 'utf-8' });
 54 |     }
 55 | 
 56 |     // Inline CSS using juice
 57 |     var stylesheets = [];
 58 | 
 59 |     // From theme
 60 |     if (fs.existsSync(defaultCSS)) {
 61 |         stylesheets.push(fs.readFileSync(defaultCSS, { encoding: 'utf-8' }));
 62 |     }
 63 | 
 64 |     // Custom PDF style
 65 |     if (this.styles.pdf) {
 66 |         stylesheets.push(fs.readFileSync(this.book.resolveOutput(this.styles.pdf), { encoding: 'utf-8' }));
 67 |     }
 68 | 
 69 |     tpl = juice(tpl, {
 70 |         extraCss: stylesheets.join('\n\n')
 71 |     });
 72 | 
 73 |     return tpl;
 74 | };
 75 | 
 76 | Generator.prototype.finish = function() {
 77 |     var that = this;
 78 | 
 79 |     return Q()
 80 |     .then(this.copyAssets)
 81 |     .then(this.copyCover)
 82 |     .then(this.writeGlossary)
 83 |     .then(this.writeSummary)
 84 |     .then(function() {
 85 |         if (!that.ebookFormat) return Q();
 86 | 
 87 |         if (!that.options.cover && fs.existsSync(path.join(that.options.output, 'cover.jpg'))) {
 88 |             that.options.cover = path.join(that.options.output, 'cover.jpg');
 89 |         }
 90 | 
 91 |         var d = Q.defer();
 92 | 
 93 |         var _options = {
 94 |             '--cover': that.options.cover,
 95 |             '--title': that.options.title,
 96 |             '--comments': that.options.description,
 97 |             '--isbn': that.options.isbn,
 98 |             '--authors': that.options.author,
 99 |             '--language': that.options.language,
100 |             '--book-producer': 'GitBook',
101 |             '--publisher': 'GitBook',
102 |             '--chapter': 'descendant-or-self::*[contains(concat(\' \', normalize-space(@class), \' \'), \' book-chapter \')]',
103 |             '--level1-toc': 'descendant-or-self::*[contains(concat(\' \', normalize-space(@class), \' \'), \' book-chapter-1 \')]',
104 |             '--level2-toc': 'descendant-or-self::*[contains(concat(\' \', normalize-space(@class), \' \'), \' book-chapter-2 \')]',
105 |             '--level3-toc': 'descendant-or-self::*[contains(concat(\' \', normalize-space(@class), \' \'), \' book-chapter-3 \')]',
106 |             '--no-chapters-in-toc': true,
107 |             '--max-levels': '1',
108 |             '--breadth-first': true
109 |         };
110 | 
111 |         if (that.ebookFormat == 'pdf') {
112 |             var pdfOptions = that.options.pdf;
113 | 
114 |             _.extend(_options, {
115 |                 '--chapter-mark': String(pdfOptions.chapterMark),
116 |                 '--page-breaks-before': String(pdfOptions.pageBreaksBefore),
117 |                 '--margin-left': String(pdfOptions.margin.left),
118 |                 '--margin-right': String(pdfOptions.margin.right),
119 |                 '--margin-top': String(pdfOptions.margin.top),
120 |                 '--margin-bottom': String(pdfOptions.margin.bottom),
121 |                 '--pdf-default-font-size': String(pdfOptions.fontSize),
122 |                 '--pdf-mono-font-size': String(pdfOptions.fontSize),
123 |                 '--paper-size': String(pdfOptions.paperSize),
124 |                 '--pdf-page-numbers': Boolean(pdfOptions.pageNumbers),
125 |                 '--pdf-header-template': that.getPDFTemplate('header'),
126 |                 '--pdf-footer-template': that.getPDFTemplate('footer'),
127 |                 '--pdf-sans-family': String(pdfOptions.fontFamily)
128 |             });
129 |         } else if (that.ebookFormat == 'epub') {
130 |             _.extend(_options, {
131 |                 '--dont-split-on-page-breaks': true
132 |             });
133 |         }
134 | 
135 |         var command = [
136 |             'ebook-convert',
137 |             path.join(that.options.output, 'SUMMARY.html'),
138 |             path.join(that.options.output, 'index.'+that.ebookFormat),
139 |             stringUtils.optionsToShellArgs(_options)
140 |         ].join(' ');
141 | 
142 |         that.book.log.info('start conversion to', that.ebookFormat, '....');
143 | 
144 |         var child = exec(command, function (error, stdout) {
145 |             if (error) {
146 |                 that.book.log.info.fail();
147 | 
148 |                 if (error.code == 127) {
149 |                     error.message = 'Need to install ebook-convert from Calibre';
150 |                 } else {
151 |                     error.message = error.message + ' '+stdout;
152 |                 }
153 |                 return d.reject(error);
154 |             }
155 | 
156 |             that.book.log.info.ok();
157 |             d.resolve();
158 |         });
159 | 
160 |         child.stdout.on('data', function (data) {
161 |             that.book.log.debug(data);
162 |         });
163 | 
164 |         child.stderr.on('data', function (data) {
165 |             that.book.log.debug(data);
166 |         });
167 | 
168 |         return d.promise;
169 |     });
170 | };
171 | 
172 | module.exports = Generator;
173 | 


--------------------------------------------------------------------------------
/lib/generators/index.js:
--------------------------------------------------------------------------------
 1 | var _ = require("lodash");
 2 | var EbookGenerator = require("./ebook");
 3 | 
 4 | module.exports = {
 5 |     json: require("./json"),
 6 |     website: require("./website"),
 7 |     ebook: EbookGenerator,
 8 |     pdf: _.partialRight(EbookGenerator, "pdf"),
 9 |     mobi: _.partialRight(EbookGenerator, "mobi"),
10 |     epub: _.partialRight(EbookGenerator, "epub")
11 | };
12 | 


--------------------------------------------------------------------------------
/lib/generators/json.js:
--------------------------------------------------------------------------------
 1 | var util = require('util');
 2 | var path = require('path');
 3 | var Q = require('q');
 4 | var _ = require('lodash');
 5 | 
 6 | var fs = require('../utils/fs');
 7 | var BaseGenerator = require('../generator');
 8 | var links = require('../utils/links');
 9 | 
10 | var Generator = function() {
11 |     BaseGenerator.apply(this, arguments);
12 | };
13 | util.inherits(Generator, BaseGenerator);
14 | 
15 | // Ignore some methods
16 | Generator.prototype.transferFile = function() { };
17 | 
18 | // Convert an input file
19 | Generator.prototype.convertFile = function(input) {
20 |     var that = this;
21 | 
22 |     return that.book.parsePage(input)
23 |     .then(function(page) {
24 |         var json = {
25 |             progress: page.progress,
26 |             sections: page.sections
27 |         };
28 | 
29 |         var output = links.changeExtension(page.path, '.json');
30 |         output = path.join(that.options.output, output);
31 | 
32 |         return fs.writeFile(
33 |             output,
34 |             JSON.stringify(json, null, 4)
35 |         );
36 |     });
37 | };
38 | 
39 | // Finish generation
40 | Generator.prototype.finish = function() {
41 |     return this.writeReadme();
42 | };
43 | 
44 | // Write README.json
45 | Generator.prototype.writeReadme = function() {
46 |     var that = this;
47 |     var mainLang, langs, readme;
48 | 
49 |     return Q()
50 |     .then(function() {
51 |         langs = that.book.langs;
52 |         mainLang = langs.length > 0? _.first(langs).lang : null;
53 | 
54 |         readme = links.changeExtension(that.book.readmeFile, '.json');
55 | 
56 |         // Read readme from main language
57 |         return fs.readFile(
58 |             mainLang? path.join(that.options.output, mainLang, readme) : path.join(that.options.output, readme)
59 |         );
60 |     })
61 |     .then(function(content) {
62 |         // Extend it with infos about the languages
63 |         var json = JSON.parse(content);
64 |         _.extend(json, {
65 |             langs: langs
66 |         });
67 | 
68 |         // Write it as README.json
69 |         return fs.writeFile(
70 |             path.join(that.options.output, 'README.json'),
71 |             JSON.stringify(json, null, 4)
72 |         );
73 |     });
74 | };
75 | 
76 | module.exports = Generator;
77 | 


--------------------------------------------------------------------------------
/lib/init.js:
--------------------------------------------------------------------------------
 1 | var _ = require('lodash');
 2 | var Q = require('q');
 3 | var path = require('path');
 4 | 
 5 | var Book = require('./book');
 6 | var fs = require('./utils/fs');
 7 | 
 8 | // Initialize folder structure for a book
 9 | // Read SUMMARY to created the right chapter
10 | function initBook(root, opts) {
11 |     var book = new Book(root, opts);
12 |     var extensionToUse = '.md';
13 | 
14 |     var chaptersPaths = function(chapters) {
15 |         return _.reduce(chapters || [], function(accu, chapter) {
16 |             var o = {
17 |                 title: chapter.title
18 |             };
19 |             if (chapter.path) o.path = chapter.path;
20 | 
21 |             return accu.concat(
22 |                 [o].concat(chaptersPaths(chapter.articles))
23 |             );
24 |         }, []);
25 |     };
26 | 
27 |     book.log.info.ln('init book at', root);
28 |     return fs.mkdirp(root)
29 |     .then(function() {
30 |         book.log.info.ln('detect structure from SUMMARY (if it exists)');
31 |         return book.parseSummary();
32 |     })
33 |     .fail(function() {
34 |         return Q();
35 |     })
36 |     .then(function() {
37 |         var summary = book.summaryFile || 'SUMMARY.md';
38 |         var chapters = book.summary.chapters || [];
39 |         extensionToUse = path.extname(summary);
40 | 
41 |         if (chapters.length === 0) {
42 |             chapters = [
43 |                 {
44 |                     title: 'Summary',
45 |                     path: 'SUMMARY'+extensionToUse
46 |                 },
47 |                 {
48 |                     title: 'Introduction',
49 |                     path: 'README'+extensionToUse
50 |                 }
51 |             ];
52 |         }
53 | 
54 |         return Q(chaptersPaths(chapters));
55 |     })
56 |     .then(function(chapters) {
57 |         // Create files that don't exist
58 |         return Q.all(_.map(chapters, function(chapter) {
59 |             if (!chapter.path) return Q();
60 |             var absolutePath = path.resolve(book.root, chapter.path);
61 | 
62 |             return fs.exists(absolutePath)
63 |             .then(function(exists) {
64 |                 if(exists) {
65 |                     book.log.info.ln('found', chapter.path);
66 |                     return;
67 |                 } else {
68 |                     book.log.info.ln('create', chapter.path);
69 |                 }
70 | 
71 |                 return fs.mkdirp(path.dirname(absolutePath))
72 |                 .then(function() {
73 |                     return fs.writeFile(absolutePath, '# '+chapter.title+'\n');
74 |                 });
75 |             });
76 |         }));
77 |     })
78 |     .then(function() {
79 |         book.log.info.ln('initialization is finished');
80 |     });
81 | }
82 | 
83 | module.exports = initBook;
84 | 


--------------------------------------------------------------------------------
/lib/utils/batch.js:
--------------------------------------------------------------------------------
 1 | var Q = require("q");
 2 | var _ = require("lodash");
 3 | 
 4 | // Execute a method for all element
 5 | function execEach(items, options) {
 6 |     if (_.size(items) === 0) return Q();
 7 |     var concurrents = 0, d = Q.defer(), pending = [];
 8 | 
 9 |     options = _.defaults(options || {}, {
10 |         max: 100,
11 |         fn: function() {}
12 |     });
13 | 
14 | 
15 |     function startItem(item, i) {
16 |         if (concurrents >= options.max) {
17 |             pending.push([item, i]);
18 |             return;
19 |         }
20 | 
21 |         concurrents++;
22 |         Q()
23 |         .then(function() {
24 |             return options.fn(item, i);
25 |         })
26 |         .then(function() {
27 |             concurrents--;
28 | 
29 |             // Next pending
30 |             var next = pending.shift();
31 | 
32 |             if (concurrents === 0 && !next) {
33 |                 d.resolve();
34 |             } else if (next) {
35 |                 startItem.apply(null, next);
36 |             }
37 |         })
38 |         .fail(function(err) {
39 |             pending = [];
40 |             d.reject(err);
41 |         });
42 |     }
43 | 
44 |     _.each(items, startItem);
45 | 
46 |     return d.promise;
47 | }
48 | 
49 | module.exports = {
50 |     execEach: execEach
51 | };
52 | 
53 | 


--------------------------------------------------------------------------------
/lib/utils/fs.js:
--------------------------------------------------------------------------------
  1 | var _ = require('lodash');
  2 | var Q = require('q');
  3 | var tmp = require('tmp');
  4 | var path = require('path');
  5 | var fs = require('graceful-fs');
  6 | var fsExtra = require('fs-extra');
  7 | var Ignore = require('fstream-ignore');
  8 | 
  9 | var fsUtils = {
 10 |     tmp: {
 11 |         file: function(opt) {
 12 |             return Q.nfcall(tmp.file.bind(tmp), opt).get(0);
 13 |         },
 14 |         dir: function() {
 15 |             return Q.nfcall(tmp.dir.bind(tmp)).get(0);
 16 |         }
 17 |     },
 18 |     list: listFiles,
 19 |     stat: Q.denodeify(fs.stat),
 20 |     readdir: Q.denodeify(fs.readdir),
 21 |     readFile: Q.denodeify(fs.readFile),
 22 |     writeFile: writeFile,
 23 |     writeStream: writeStream,
 24 |     mkdirp: Q.denodeify(fsExtra.mkdirp),
 25 |     copy: Q.denodeify(fsExtra.copy),
 26 |     remove: Q.denodeify(fsExtra.remove),
 27 |     symlink: Q.denodeify(fsExtra.symlink),
 28 |     exists: function(path) {
 29 |         var d = Q.defer();
 30 |         fs.exists(path, d.resolve);
 31 |         return d.promise;
 32 |     },
 33 |     findFile: findFile,
 34 |     existsSync: fs.existsSync.bind(fs),
 35 |     readFileSync: fs.readFileSync.bind(fs),
 36 |     clean: cleanFolder,
 37 |     getUniqueFilename: getUniqueFilename
 38 | };
 39 | 
 40 | // Write a file
 41 | function writeFile(filename, data, options) {
 42 |     var d = Q.defer();
 43 | 
 44 |     try {
 45 |         fs.writeFileSync(filename, data, options);
 46 |     } catch(err) {
 47 |         d.reject(err);
 48 |     }
 49 |     d.resolve();
 50 | 
 51 | 
 52 |     return d.promise;
 53 | }
 54 | 
 55 | // Write a stream to a file
 56 | function writeStream(filename, st) {
 57 |     var d = Q.defer();
 58 | 
 59 |     var wstream = fs.createWriteStream(filename);
 60 | 
 61 |     wstream.on('finish', function () {
 62 |         d.resolve();
 63 |     });
 64 |     wstream.on('error', function (err) {
 65 |         d.reject(err);
 66 |     });
 67 | 
 68 |     st.on('error', function(err) {
 69 |         d.reject(err);
 70 |     });
 71 | 
 72 |     st.pipe(wstream);
 73 | 
 74 |     return d.promise;
 75 | }
 76 | 
 77 | // Find a filename available
 78 | function getUniqueFilename(base, filename) {
 79 |     if (!filename) {
 80 |         filename = base;
 81 |         base = '/';
 82 |     }
 83 | 
 84 |     filename = path.resolve(base, filename);
 85 |     var ext = path.extname(filename);
 86 |     filename = path.join(path.dirname(filename), path.basename(filename, ext));
 87 | 
 88 |     var _filename = filename+ext;
 89 | 
 90 |     var i = 0;
 91 |     while (fs.existsSync(filename)) {
 92 |         _filename = filename+'_'+i+ext;
 93 |         i = i + 1;
 94 |     }
 95 | 
 96 |     return path.relative(base, _filename);
 97 | }
 98 | 
 99 | 
100 | // List files in a directory
101 | function listFiles(root, options) {
102 |     options = _.defaults(options || {}, {
103 |         ignoreFiles: [],
104 |         ignoreRules: []
105 |     });
106 | 
107 |     var d = Q.defer();
108 | 
109 |     // Our list of files
110 |     var files = [];
111 | 
112 |     var ig = Ignore({
113 |         path: root,
114 |         ignoreFiles: options.ignoreFiles
115 |     });
116 | 
117 |     // Add extra rules to ignore common folders
118 |     ig.addIgnoreRules(options.ignoreRules, '__custom_stuff');
119 | 
120 |     // Push each file to our list
121 |     ig.on('child', function (c) {
122 |         files.push(
123 |             c.path.substr(c.root.path.length + 1) + (c.props.Directory === true ? '/' : '')
124 |         );
125 |     });
126 | 
127 |     ig.on('end', function() {
128 |         // Normalize paths on Windows
129 |         if(process.platform === 'win32') {
130 |             return d.resolve(files.map(function(file) {
131 |                 return file.replace(/\\/g, '/');
132 |             }));
133 |         }
134 | 
135 |         // Simply return paths otherwise
136 |         return d.resolve(files);
137 |     });
138 | 
139 |     ig.on('error', d.reject);
140 | 
141 |     return d.promise;
142 | }
143 | 
144 | // Clean a folder without removing .git and .svn
145 | // Creates it if non existant
146 | function cleanFolder(root) {
147 |     if (!fs.existsSync(root)) return fsUtils.mkdirp(root);
148 | 
149 |     return listFiles(root, {
150 |         ignoreFiles: [],
151 |         ignoreRules: [
152 |             // Skip Git and SVN stuff
153 |             '.git/',
154 |             '.svn/'
155 |         ]
156 |     })
157 |     .then(function(files) {
158 |         var d = Q.defer();
159 | 
160 |         _.reduce(files, function(prev, file, i) {
161 |             return prev.then(function() {
162 |                 var _file = path.join(root, file);
163 | 
164 |                 d.notify({
165 |                     i: i+1,
166 |                     count: files.length,
167 |                     file: _file
168 |                 });
169 |                 return fsUtils.remove(_file);
170 |             });
171 |         }, Q())
172 |         .then(function() {
173 |             d.resolve();
174 |         }, function(err) {
175 |             d.reject(err);
176 |         });
177 | 
178 |         return d.promise;
179 |     });
180 | }
181 | 
182 | // Find a file in a folder (case incensitive)
183 | // Return the real filename
184 | function findFile(root, filename) {
185 |     return Q.nfcall(fs.readdir, root)
186 |     .then(function(files) {
187 |         return _.find(files, function(file) {
188 |             return (file.toLowerCase() == filename.toLowerCase());
189 |         });
190 |     });
191 | }
192 | 
193 | module.exports = fsUtils;
194 | 


--------------------------------------------------------------------------------
/lib/utils/git.js:
--------------------------------------------------------------------------------
  1 | var  Q = require('q');
  2 | var _ = require('lodash');
  3 | var path = require('path');
  4 | var crc = require('crc');
  5 | var exec = Q.denodeify(require('child_process').exec);
  6 | var URI = require('urijs');
  7 | var pathUtil = require('./path');
  8 | 
  9 | var fs = require('./fs');
 10 | 
 11 | var GIT_PREFIX = 'git+';
 12 | var GIT_TMP = null;
 13 | 
 14 | 
 15 | // Check if an url is a git dependency url
 16 | function checkGitUrl(giturl) {
 17 |     return (giturl.indexOf(GIT_PREFIX) === 0);
 18 | }
 19 | 
 20 | // Validates a SHA in hexadecimal
 21 | function validateSha(str) {
 22 |     return (/[0-9a-f]{40}/).test(str);
 23 | }
 24 | 
 25 | // Parse and extract infos
 26 | function parseGitUrl(giturl) {
 27 |     var ref, uri, fileParts, filepath;
 28 | 
 29 |     if (!checkGitUrl(giturl)) return null;
 30 |     giturl = giturl.slice(GIT_PREFIX.length);
 31 | 
 32 |     uri = new URI(giturl);
 33 |     ref = uri.fragment() || 'master';
 34 |     uri.fragment(null);
 35 | 
 36 |     // Extract file inside the repo (after the .git)
 37 |     fileParts =uri.path().split('.git');
 38 |     filepath = fileParts.length > 1? fileParts.slice(1).join('.git') : '';
 39 |     if (filepath[0] == '/') filepath = filepath.slice(1);
 40 | 
 41 |     // Recreate pathname without the real filename
 42 |     uri.path(_.first(fileParts)+'.git');
 43 | 
 44 |     return {
 45 |         host: uri.toString(),
 46 |         ref: ref || 'master',
 47 |         filepath: filepath
 48 |     };
 49 | }
 50 | 
 51 | // Clone a git repo from a specific ref
 52 | function cloneGitRepo(host, ref) {
 53 |     var isBranch = false;
 54 | 
 55 |     ref = ref || 'master';
 56 |     if (!validateSha(ref)) isBranch = true;
 57 | 
 58 |     return Q()
 59 | 
 60 |     // Create temporary folder to store git repos
 61 |     .then(function() {
 62 |         if (GIT_TMP) return;
 63 |         return fs.tmp.dir()
 64 |             .then(function(_tmp) {
 65 |                 GIT_TMP = _tmp;
 66 |             });
 67 |     })
 68 | 
 69 |     // Return or clone the git repo
 70 |     .then(function() {
 71 |         // Unique ID for repo/ref combinaison
 72 |         var repoId = crc.crc32(host+'#'+ref).toString(16);
 73 | 
 74 |         // Absolute path to the folder
 75 |         var repoPath = path.resolve(GIT_TMP, repoId);
 76 | 
 77 |         return fs.exists(repoPath)
 78 |             .then(function(doExists) {
 79 |                 if (doExists) return;
 80 | 
 81 |                 // Clone repo
 82 |                 return exec('git clone '+host+' '+repoPath)
 83 |                 .then(function() {
 84 |                     return exec('git checkout '+ref, { cwd: repoPath });
 85 |                 });
 86 |             })
 87 |             .thenResolve(repoPath);
 88 |     });
 89 | }
 90 | 
 91 | // Get file from a git repo
 92 | function resolveFileFromGit(giturl) {
 93 |     if (_.isString(giturl)) giturl = parseGitUrl(giturl);
 94 |     if (!giturl) return Q(null);
 95 | 
 96 |     // Clone or get from cache
 97 |     return cloneGitRepo(giturl.host, giturl.ref)
 98 |     .then(function(repo) {
 99 | 
100 |         // Resolve relative path
101 |         return path.resolve(repo, giturl.filepath);
102 |     });
103 | }
104 | 
105 | // Return root of git repo from a filepath
106 | function resolveGitRoot(filepath) {
107 |     var relativeToGit, repoId;
108 | 
109 |     // No git repo cloned, or file is not in a git repository
110 |     if (!GIT_TMP || !pathUtil.isInRoot(GIT_TMP, filepath)) return null;
111 | 
112 |     // Extract first directory (is the repo id)
113 |     relativeToGit = path.relative(GIT_TMP, filepath);
114 |     repoId = _.first(relativeToGit.split(path.sep));
115 |     if (!repoId) return;
116 | 
117 |     // Return an absolute file
118 |     return path.resolve(GIT_TMP, repoId);
119 | }
120 | 
121 | 
122 | module.exports = {
123 |     checkUrl: checkGitUrl,
124 |     parseUrl: parseGitUrl,
125 |     resolveFile: resolveFileFromGit,
126 |     resolveRoot: resolveGitRoot
127 | };
128 | 


--------------------------------------------------------------------------------
/lib/utils/i18n.js:
--------------------------------------------------------------------------------
 1 | var _ = require('lodash');
 2 | var path = require('path');
 3 | var fs = require('fs');
 4 | 
 5 | var i18n = require('i18n');
 6 | 
 7 | var I18N_PATH = path.resolve(__dirname, '../../theme/i18n/');
 8 | var DEFAULT_LANGUAGE = 'en';
 9 | var LOCALES = _.map(fs.readdirSync(I18N_PATH), function(lang) {
10 |     return path.basename(lang, '.json');
11 | });
12 | 
13 | i18n.configure({
14 |     locales: LOCALES,
15 |     directory: I18N_PATH,
16 |     defaultLocale: DEFAULT_LANGUAGE,
17 |     updateFiles: false
18 | });
19 | 
20 | function compareLocales(lang, locale) {
21 |     var langMain = _.first(lang.split('-'));
22 |     var langSecond = _.last(lang.split('-'));
23 | 
24 |     var localeMain = _.first(locale.split('-'));
25 |     var localeSecond = _.last(locale.split('-'));
26 | 
27 |     if (locale == lang) return 100;
28 |     if (localeMain == langMain) return 50;
29 |     if (localeSecond == langSecond) return 20;
30 |     return 0;
31 | }
32 | 
33 | var normalizeLanguage = _.memoize(function(lang) {
34 |     var language = _.chain(LOCALES)
35 |         .values()
36 |         .map(function(locale) {
37 |             return {
38 |                 locale: locale,
39 |                 score: compareLocales(lang, locale)
40 |             };
41 |         })
42 |         .filter(function(lang) {
43 |             return lang.score > 0;
44 |         })
45 |         .sortBy('score')
46 |         .pluck('locale')
47 |         .last()
48 |         .value();
49 |     return language || lang;
50 | });
51 | 
52 | function translate(locale, phrase) {
53 |     var args = Array.prototype.slice.call(arguments, 2);
54 | 
55 |     return i18n.__.apply({}, [{
56 |         locale: locale,
57 |         phrase: phrase
58 |     }].concat(args));
59 | }
60 | 
61 | function getCatalog(locale) {
62 |     locale = normalizeLanguage(locale);
63 |     return i18n.getCatalog(locale);
64 | }
65 | 
66 | function getLocales() {
67 |     return LOCALES;
68 | }
69 | 
70 | function hasLocale(locale) {
71 |     return _.contains(LOCALES, locale);
72 | }
73 | 
74 | module.exports = {
75 |     __: translate,
76 |     normalizeLanguage: normalizeLanguage,
77 |     getCatalog: getCatalog,
78 |     getLocales: getLocales,
79 |     hasLocale: hasLocale
80 | };
81 | 


--------------------------------------------------------------------------------
/lib/utils/images.js:
--------------------------------------------------------------------------------
 1 | var _ = require("lodash");
 2 | var Q = require("q");
 3 | var fs = require("./fs");
 4 | var spawn = require("spawn-cmd").spawn;
 5 | 
 6 | // Convert a svg file
 7 | var convertSVG = function(source, dest, options) {
 8 |     if (!fs.existsSync(source)) return Q.reject(new Error("File doesn't exist: "+source));
 9 |     var d = Q.defer();
10 | 
11 |     options = _.defaults(options || {}, {
12 | 
13 |     });
14 | 
15 |     //var command = shellescape(["svgexport", source, dest]);
16 |     var child = spawn("svgexport", [source, dest]);
17 | 
18 |     child.on("error", function(error) {
19 |         if (error.code == "ENOENT") error = new Error("Need to install \"svgexport\" using \"npm install svgexport -g\"");
20 |         return d.reject(error);
21 |     });
22 | 
23 |     child.on("close", function(code) {
24 |         if (code === 0 && fs.existsSync(dest)) {
25 |             d.resolve();
26 |         } else {
27 |             d.reject(new Error("Error converting "+source+" into "+dest));
28 |         }
29 |     });
30 | 
31 |     return d.promise;
32 | };
33 | 
34 | module.exports = {
35 |     convertSVG: convertSVG,
36 |     INVALID: [".svg"]
37 | };
38 | 


--------------------------------------------------------------------------------
/lib/utils/links.js:
--------------------------------------------------------------------------------
 1 | var url = require("url");
 2 | var path = require("path");
 3 | 
 4 | // Is the link an external link
 5 | var isExternal = function(href) {
 6 |     try {
 7 |         return Boolean(url.parse(href).protocol);
 8 |     } catch(err) { }
 9 | 
10 |     return false;
11 | };
12 | 
13 | // Return true if the link is relative
14 | var isRelative = function(href) {
15 |     try {
16 |         var parsed = url.parse(href);
17 | 
18 |         return !!(!parsed.protocol && parsed.path);
19 |     } catch(err) {}
20 | 
21 |     return true;
22 | };
23 | 
24 | // Return true if the link is an achor
25 | var isAnchor = function(href) {
26 |     try {
27 |         var parsed = url.parse(href);
28 |         return !!(!parsed.protocol && !parsed.path && parsed.hash);
29 |     } catch(err) {}
30 | 
31 |     return false;
32 | };
33 | 
34 | // Normalize a path to be a link
35 | var normalizeLink = function(s) {
36 |     return s.replace(/\\/g, "/");
37 | };
38 | 
39 | // Relative to absolute path
40 | // dir: directory parent of the file currently in rendering process
41 | // outdir: directory parent from the html output
42 | 
43 | var toAbsolute = function(_href, dir, outdir) {
44 |     if (isExternal(_href)) return _href;
45 | 
46 |     // Path "_href" inside the base folder
47 |     var hrefInRoot = path.normalize(path.join(dir, _href));
48 |     if (_href[0] == "/") hrefInRoot = path.normalize(_href.slice(1));
49 | 
50 |     // Make it relative to output
51 |     _href = path.relative(outdir, hrefInRoot);
52 | 
53 |     // Normalize windows paths
54 |     _href = normalizeLink(_href);
55 | 
56 |     return _href;
57 | };
58 | 
59 | // Join links
60 | var join = function() {
61 |     var _href = path.join.apply(path, arguments);
62 | 
63 |     return normalizeLink(_href);
64 | };
65 | 
66 | // Change extension
67 | var changeExtension = function(filename, newext) {
68 |     return path.join(
69 |         path.dirname(filename),
70 |         path.basename(filename, path.extname(filename))+newext
71 |     );
72 | };
73 | 
74 | module.exports = {
75 |     isAnchor: isAnchor,
76 |     isRelative: isRelative,
77 |     isExternal: isExternal,
78 |     toAbsolute: toAbsolute,
79 |     join: join,
80 |     changeExtension: changeExtension,
81 |     normalize: normalizeLink
82 | };
83 | 


--------------------------------------------------------------------------------
/lib/utils/logger.js:
--------------------------------------------------------------------------------
  1 | var _ = require("lodash");
  2 | var util = require("util");
  3 | var color = require("bash-color");
  4 | 
  5 | var LEVELS = {
  6 |     DEBUG: 0,
  7 |     INFO: 1,
  8 |     WARN: 2,
  9 |     ERROR: 3,
 10 |     DISABLED: 10
 11 | };
 12 | 
 13 | var COLORS = {
 14 |     DEBUG: color.purple,
 15 |     INFO: color.cyan,
 16 |     WARN: color.yellow,
 17 |     ERROR: color.red
 18 | };
 19 | 
 20 | module.exports = function(_write, logLevel) {
 21 |     var logger = {};
 22 |     var lastChar = "\n";
 23 |     if (_.isString(logLevel)) logLevel = LEVELS[logLevel.toUpperCase()];
 24 | 
 25 |     // Write a simple message
 26 |     logger.write = function(msg) {
 27 |         msg = msg.toString();
 28 |         lastChar = _.last(msg);
 29 |         return _write(msg);
 30 |     };
 31 | 
 32 |     // Format a message
 33 |     logger.format = function() {
 34 |         return util.format.apply(util, arguments);
 35 |     };
 36 | 
 37 |     // Write a line
 38 |     logger.writeLn = function(msg) {
 39 |         return this.write((msg || "")+"\n");
 40 |     };
 41 | 
 42 |     // Write a message with a certain level
 43 |     logger.log = function(level) {
 44 |         if (level < logLevel) return;
 45 | 
 46 |         var levelKey = _.findKey(LEVELS, function(v) { return v == level; });
 47 |         var args = Array.prototype.slice.apply(arguments, [1]);
 48 |         var msg = logger.format.apply(logger, args);
 49 | 
 50 |         if (lastChar == "\n") {
 51 |             msg = COLORS[levelKey](levelKey.toLowerCase()+":")+" "+msg;
 52 |         }
 53 | 
 54 |         return logger.write(msg);
 55 |     };
 56 |     logger.logLn = function() {
 57 |         if (lastChar != "\n") logger.write("\n");
 58 | 
 59 |         var args = Array.prototype.slice.apply(arguments);
 60 |         args.push("\n");
 61 |         logger.log.apply(logger, args);
 62 |     };
 63 | 
 64 |     // Write a OK
 65 |     logger.ok = function(level) {
 66 |         var args = Array.prototype.slice.apply(arguments, [1]);
 67 |         var msg = logger.format.apply(logger, args);
 68 |         if (arguments.length > 1) {
 69 |             logger.logLn(level, color.green(">> ") + msg.trim().replace(/\n/g, color.green("\n>> ")));
 70 |         } else {
 71 |             logger.log(level, color.green("OK"), "\n");
 72 |         }
 73 |     };
 74 | 
 75 |     // Write an "FAIL"
 76 |     logger.fail = function(level) {
 77 |         return logger.log(level, color.red("ERROR")+"\n");
 78 |     };
 79 | 
 80 |     _.each(_.omit(LEVELS, "DISABLED"), function(level, levelKey) {
 81 |         levelKey = levelKey.toLowerCase();
 82 | 
 83 |         logger[levelKey] = _.partial(logger.log, level);
 84 |         logger[levelKey].ln = _.partial(logger.logLn, level);
 85 |         logger[levelKey].ok = _.partial(logger.ok, level);
 86 |         logger[levelKey].fail = _.partial(logger.fail, level);
 87 |         logger[levelKey].promise = function(p) {
 88 |             return p.
 89 |             then(function(st) {
 90 |                 logger[levelKey].ok();
 91 |                 return st;
 92 |             }, function(err) {
 93 |                 logger[levelKey].fail();
 94 |                 throw err;
 95 |             });
 96 |         };
 97 |     });
 98 | 
 99 |     return logger;
100 | };
101 | module.exports.LEVELS = LEVELS;
102 | module.exports.COLORS = COLORS;
103 | 


--------------------------------------------------------------------------------
/lib/utils/navigation.js:
--------------------------------------------------------------------------------
 1 | var _ = require("lodash");
 2 | 
 3 | // Cleans up an article/chapter object
 4 | // remove "articles" attributes
 5 | function clean(obj) {
 6 |     return obj && _.omit(obj, ["articles"]);
 7 | }
 8 | 
 9 | function flattenChapters(chapters) {
10 |     return _.reduce(chapters, function(accu, chapter) {
11 |         return accu.concat([clean(chapter)].concat(flattenChapters(chapter.articles)));
12 |     }, []);
13 | }
14 | 
15 | // Returns from a summary a map of
16 | /*
17 |     {
18 |         "file/path.md": {
19 |             prev: ...,
20 |             next: ...,
21 |         },
22 |         ...
23 |     }
24 | */
25 | function navigation(summary, files) {
26 |     // Support single files as well as list
27 |     files = _.isArray(files) ? files : (_.isString(files) ? [files] : null);
28 | 
29 |     // List of all navNodes
30 |     // Flatten chapters
31 |     var navNodes = flattenChapters(summary.chapters);
32 | 
33 |     // Mapping of prev/next for a give path
34 |     var mapping = _.chain(navNodes)
35 |     .map(function(current, i) {
36 |         var prev = null, next = null;
37 | 
38 |         // Skip if no path
39 |         if(!current.exists) return null;
40 | 
41 |         // Find prev
42 |         prev = _.chain(navNodes.slice(0, i))
43 |             .reverse()
44 |             .find(function(node) {
45 |                 return node.exists && !node.external;
46 |             })
47 |             .value();
48 | 
49 |         // Find next
50 |         next = _.chain(navNodes.slice(i+1))
51 |             .find(function(node) {
52 |                 return node.exists && !node.external;
53 |             })
54 |             .value();
55 | 
56 |         return [current.path, {
57 |             index: i,
58 |             title: current.title,
59 |             introduction: current.introduction,
60 |             prev: prev,
61 |             next: next,
62 |             level: current.level,
63 |         }];
64 |     })
65 |     .compact()
66 |     .object()
67 |     .value();
68 | 
69 |     // Filter for only files we want
70 |     if(files) {
71 |         return _.pick(mapping, files);
72 |     }
73 | 
74 |     return mapping;
75 | }
76 | 
77 | 
78 | // Exports
79 | module.exports = navigation;
80 | 


--------------------------------------------------------------------------------
/lib/utils/path.js:
--------------------------------------------------------------------------------
 1 | var _ = require("lodash");
 2 | var path = require("path");
 3 | 
 4 | // Return true if file path is inside a folder
 5 | function isInRoot(root, filename) {
 6 |     filename = path.normalize(filename);
 7 |     return (filename.substr(0, root.length) === root);
 8 | }
 9 | 
10 | // Resolve paths in a specific folder
11 | // Throw error if file is outside this folder
12 | function resolveInRoot(root) {
13 |     var input, result, err;
14 | 
15 |     input = _.chain(arguments)
16 |         .toArray()
17 |         .slice(1)
18 |         .reduce(function(current, p) {
19 |             // Handle path relative to book root ("/README.md")
20 |             if (p[0] == "/" || p[0] == "\\") return p.slice(1);
21 | 
22 |             return current? path.join(current, p) : path.normalize(p);
23 |         }, "")
24 |         .value();
25 | 
26 |     result = path.resolve(root, input);
27 | 
28 |     if (!isInRoot(root, result)) {
29 |         err = new Error("EACCESS: \"" + result + "\" not in \"" + root + "\"");
30 |         err.code = "EACCESS";
31 |         throw err;
32 |     }
33 | 
34 |     return result;
35 | }
36 | 
37 | module.exports = {
38 |     isInRoot: isInRoot,
39 |     resolveInRoot: resolveInRoot
40 | };
41 | 


--------------------------------------------------------------------------------
/lib/utils/progress.js:
--------------------------------------------------------------------------------
 1 | var _ = require('lodash');
 2 | 
 3 | // Returns from a navigation and a current file, a snapshot of current detailed state
 4 | function calculProgress(navigation, current) {
 5 |     var n = _.size(navigation);
 6 |     var percent = 0, prevPercent = 0, currentChapter = null;
 7 |     var done = true;
 8 | 
 9 |     var chapters = _.chain(navigation)
10 | 
11 |     // Transform as array
12 |     .map(function(nav, path) {
13 |         nav.path = path;
14 |         return nav;
15 |     })
16 | 
17 |     // Sort entries
18 |     .sortBy(function(nav) {
19 |         return nav.index;
20 |     })
21 | 
22 |     .map(function(nav, i) {
23 |         // Calcul percent
24 |         nav.percent = (i * 100) / Math.max((n - 1), 1);
25 | 
26 |         // Is it done
27 |         nav.done = done;
28 |         if (nav.path == current) {
29 |             currentChapter = nav;
30 |             percent = nav.percent;
31 |             done = false;
32 |         } else if (done) {
33 |             prevPercent = nav.percent;
34 |         }
35 | 
36 |         return nav;
37 |     })
38 |     .value();
39 | 
40 |     return {
41 |         // Previous percent
42 |         prevPercent: prevPercent,
43 | 
44 |         // Current percent
45 |         percent: percent,
46 | 
47 |         // List of chapter with progress
48 |         chapters: chapters,
49 | 
50 |         // Current chapter
51 |         current: currentChapter
52 |     };
53 | }
54 | 
55 | module.exports = calculProgress;
56 | 


--------------------------------------------------------------------------------
/lib/utils/server.js:
--------------------------------------------------------------------------------
 1 | var Q = require("q");
 2 | var events = require("events");
 3 | var http = require("http");
 4 | var send = require("send");
 5 | var util = require("util");
 6 | var url = require("url");
 7 | 
 8 | var Server = function() {
 9 |     this.running = null;
10 |     this.dir = null;
11 |     this.port = 0;
12 |     this.sockets = [];
13 | };
14 | util.inherits(Server, events.EventEmitter);
15 | 
16 | // Return true if the server is running
17 | Server.prototype.isRunning = function() {
18 |     return !!this.running;
19 | };
20 | 
21 | // Stop the server
22 | Server.prototype.stop = function() {
23 |     var that = this;
24 |     if (!this.isRunning()) return Q();
25 | 
26 |     var d = Q.defer();
27 |     this.running.close(function(err) {
28 |         that.running = null;
29 |         that.emit("state", false);
30 | 
31 |         if (err) d.reject(err);
32 |         else d.resolve();
33 |     });
34 | 
35 |     for (var i = 0; i < this.sockets.length; i++) {
36 |         this.sockets[i].destroy();
37 |     }
38 | 
39 |     return d.promise;
40 | };
41 | 
42 | Server.prototype.start = function(dir, port) {
43 |     var that = this, pre = Q();
44 |     port = port || 8004;
45 | 
46 |     if (that.isRunning()) pre = this.stop();
47 |     return pre
48 |     .then(function() {
49 |         var d = Q.defer();
50 | 
51 |         that.running = http.createServer(function(req, res){
52 |             // Render error
53 |             function error(err) {
54 |                 res.statusCode = err.status || 500;
55 |                 res.end(err.message);
56 |             }
57 | 
58 |             // Redirect to directory"s index.html
59 |             function redirect() {
60 |                 res.statusCode = 301;
61 |                 res.setHeader("Location", req.url + "/");
62 |                 res.end("Redirecting to " + req.url + "/");
63 |             }
64 | 
65 |             // Send file
66 |             send(req, url.parse(req.url).pathname)
67 |             .root(dir)
68 |             .on("error", error)
69 |             .on("directory", redirect)
70 |             .pipe(res);
71 |         });
72 | 
73 |         that.running.on("connection", function (socket) {
74 |             that.sockets.push(socket);
75 |             socket.setTimeout(4000);
76 |             socket.on("close", function () {
77 |                 that.sockets.splice(that.sockets.indexOf(socket), 1);
78 |             });
79 |         });
80 | 
81 |         that.running.listen(port, function(err) {
82 |             if (err) return d.reject(err);
83 | 
84 |             that.port = port;
85 |             that.dir = dir;
86 |             that.emit("state", true);
87 |             d.resolve();
88 |         });
89 | 
90 |         return d.promise;
91 |     });
92 | };
93 | 
94 | module.exports = Server;
95 | 


--------------------------------------------------------------------------------
/lib/utils/string.js:
--------------------------------------------------------------------------------
 1 | var _ = require("lodash");
 2 | 
 3 | function escapeShellArg(arg) {
 4 |     var ret = "";
 5 | 
 6 |     ret = arg.replace(/"/g, '\\"');
 7 | 
 8 |     return "\"" + ret + "\"";
 9 | }
10 | 
11 | function optionsToShellArgs(options) {
12 |     return _.chain(options)
13 |     .map(function(value, key) {
14 |         if (value === null || value === undefined || value === false) return null;
15 |         if (value === true) return key;
16 |         return key+"="+escapeShellArg(value);
17 |     })
18 |     .compact()
19 |     .value()
20 |     .join(" ");
21 | }
22 | 
23 | module.exports = {
24 |     escapeShellArg: escapeShellArg,
25 |     optionsToShellArgs: optionsToShellArgs,
26 |     toLowerCase: String.prototype.toLowerCase.call.bind(String.prototype.toLowerCase)
27 | };
28 | 


--------------------------------------------------------------------------------
/lib/utils/watch.js:
--------------------------------------------------------------------------------
 1 | var Q = require("q");
 2 | var _ = require("lodash");
 3 | var path = require("path");
 4 | var chokidar = require("chokidar");
 5 | 
 6 | var parsers = require("gitbook-parsers");
 7 | 
 8 | function watch(dir) {
 9 |     var d = Q.defer();
10 |     dir = path.resolve(dir);
11 | 
12 |     var toWatch = [
13 |         "book.json", "book.js"
14 |     ];
15 | 
16 |     _.each(parsers.extensions, function(ext) {
17 |         toWatch.push("**/*"+ext);
18 |     });
19 | 
20 |     var watcher = chokidar.watch(toWatch, {
21 |         cwd: dir,
22 |         ignored: "_book/**",
23 |         ignoreInitial: true
24 |     });
25 | 
26 |     watcher.once("all", function(e, filepath) {
27 |         watcher.close();
28 | 
29 |         d.resolve(filepath);
30 |     });
31 |     watcher.once("error", function(err) {
32 |         watcher.close();
33 | 
34 |         d.reject(err);
35 |     });
36 | 
37 |     return d.promise;
38 | }
39 | 
40 | module.exports = watch;
41 | 


--------------------------------------------------------------------------------
/lib/version.js:
--------------------------------------------------------------------------------
 1 | var semver = require('semver');
 2 | var pkg = require('../package.json');
 3 | 
 4 | var VERSION = pkg.version;
 5 | var VERSION_STABLE = VERSION.replace(/\-(\S+)/g, '');
 6 | 
 7 | // Test if current current gitbook version satisfies a condition
 8 | // We can't directly use samver.satisfies since it will break all plugins when gitbook version is a prerelease (beta, alpha)
 9 | function satisfies(condition) {
10 |     // Test with real version
11 |     if (semver.satisfies(VERSION, condition)) return true;
12 | 
13 |     // Test with future stable release
14 |     return semver.satisfies(VERSION_STABLE, condition);
15 | }
16 | 
17 | module.exports = {
18 |     satisfies: satisfies
19 | };
20 | 


--------------------------------------------------------------------------------
/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "gitbook",
 3 |     "version": "2.6.6",
 4 |     "homepage": "https://www.gitbook.com",
 5 |     "description": "Library and cmd utility to generate GitBooks",
 6 |     "main": "lib/index.js",
 7 |     "dependencies": {
 8 |         "q": "1.0.1",
 9 |         "lodash": "3.10.1",
10 |         "graceful-fs": "3.0.5",
11 |         "resolve": "0.6.3",
12 |         "fs-extra": "0.16.5",
13 |         "fstream-ignore": "1.0.2",
14 |         "gitbook-parsers": "0.8.9",
15 |         "gitbook-plugin-highlight": "1.0.3",
16 |         "gitbook-plugin-sharing": "1.0.1",
17 |         "gitbook-plugin-search": "1.1.0",
18 |         "gitbook-plugin-fontsettings": "1.0.2",
19 |         "nunjucks": "2.2.0",
20 |         "nunjucks-autoescape": "1.0.0",
21 |         "nunjucks-filter": "1.0.0",
22 |         "i18n": "0.5.0",
23 |         "semver": "5.0.1",
24 |         "npmi": "0.1.1",
25 |         "cheerio": "0.19.0",
26 |         "gitbook-plugin-livereload": "0.0.1",
27 |         "chokidar": "~1.0.5",
28 |         "send": "0.2.0",
29 |         "tiny-lr": "0.2.1",
30 |         "tmp": "0.0.24",
31 |         "crc": "3.2.1",
32 |         "bash-color": "0.0.3",
33 |         "urijs": "1.17.0",
34 |         "request": "2.51.0",
35 |         "npm": "2.4.1",
36 |         "dom-serializer": "0.1.0",
37 |         "spawn-cmd": "0.0.2",
38 |         "escape-string-regexp": "1.0.3",
39 |         "juice": "1.5.0",
40 |         "jsonschema": "1.0.2",
41 |         "json-schema-defaults": "0.1.1",
42 |         "merge-defaults": "0.2.1",
43 |         "github-slugid": "1.0.0"
44 |     },
45 |     "devDependencies": {
46 |         "eslint": "1.5.0",
47 |         "mocha": "2.3.2",
48 |         "should": "7.1.0",
49 |         "should-promised": "0.3.1",
50 |         "gulp": "^3.8.11",
51 |         "gulp-rename": "^1.2.2",
52 |         "gulp-uglify": "1.1.0",
53 |         "gulp-less": "3.0.2",
54 |         "gulp-minify-css": "1.0.0",
55 |         "gulp-util": "3.0.6",
56 |         "browserify": "11.0.1",
57 |         "merge-stream": "0.1.7",
58 |         "vinyl-source-stream": "1.1.0",
59 |         "jquery": "2.1.4",
60 |         "mousetrap": "1.5.3",
61 |         "font-awesome": "4.1.0",
62 |         "gitbook-markdown-css": "1.0.1"
63 |     },
64 |     "scripts": {
65 |         "test": "node_modules/.bin/mocha --reporter spec --timeout 15000"
66 |     },
67 |     "repository": {
68 |         "type": "git",
69 |         "url": "https://github.com/GitbookIO/gitbook.git"
70 |     },
71 |     "bin": {
72 |         "gitbook": "./bin/gitbook.js"
73 |     },
74 |     "keywords": [
75 |         "git",
76 |         "book",
77 |         "gitbook"
78 |     ],
79 |     "author": "FriendCode Inc. <contact@gitbook.com>",
80 |     "license": "Apache-2.0",
81 |     "bugs": {
82 |         "url": "https://github.com/GitbookIO/gitbook/issues"
83 |     },
84 |     "contributors": [
85 |         {
86 |             "name": "Aaron O'Mullan",
87 |             "email": "aaron@gitbook.com"
88 |         },
89 |         {
90 |             "name": "Samy Pessé",
91 |             "email": "samy@gitbook.com"
92 |         }
93 |     ]
94 | }
95 | 


--------------------------------------------------------------------------------
/preview.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/lwdgit/gitbook/7ea236981098f287dab5fa84c1e471217e414af7/preview.png


--------------------------------------------------------------------------------
/test/assertions.js:
--------------------------------------------------------------------------------
 1 | var _ = require('lodash');
 2 | var fs = require('fs');
 3 | var path = require('path');
 4 | var should = require('should');
 5 | var cheerio = require('cheerio');
 6 | 
 7 | require('should-promised');
 8 | 
 9 | should.Assertion.add('file', function(file, description) {
10 |     this.params = { actual: this.obj.toString(), operator: 'have file ' + file, message: description };
11 | 
12 |     this.obj.should.have.property('options').which.is.an.Object();
13 |     this.obj.options.should.have.property('output').which.is.a.String();
14 |     this.assert(fs.existsSync(path.resolve(this.obj.options.output, file)));
15 | });
16 | 
17 | should.Assertion.add('jsonfile', function(file, description) {
18 |     this.params = { actual: this.obj.toString(), operator: 'have valid jsonfile ' + file, message: description };
19 | 
20 |     this.obj.should.have.property('options').which.is.an.Object();
21 |     this.obj.options.should.have.property('output').which.is.a.String();
22 |     this.assert(JSON.parse(fs.readFileSync(path.resolve(this.obj.options.output, file), { encoding: 'utf-8' })));
23 | });
24 | 
25 | should.Assertion.add('html', function(rules, description) {
26 |     this.params = { actual: 'HTML string', operator: 'valid html', message: description };
27 |     var $ = cheerio.load(this.obj);
28 | 
29 |     _.each(rules, function(validations, query) {
30 |         validations = _.defaults(validations || {}, {
31 |             // Select a specific element in the list of matched elements
32 |             index: null,
33 | 
34 |             // Check that there is the correct count of elements
35 |             count: 1,
36 | 
37 |             // Check attribute values
38 |             attributes: {},
39 | 
40 |             // Trim inner text
41 |             trim: false,
42 | 
43 |             // Check inner text
44 |             text: undefined
45 |         });
46 | 
47 |         var $el = $(query);
48 | 
49 |         // Select correct element
50 |         if (_.isNumber(validations.index)) $el = $($el.get(validations.index));
51 | 
52 |         // Test number of elements
53 |         $el.length.should.be.equal(validations.count);
54 | 
55 |         // Test text
56 |         if (validations.text !== undefined) {
57 |             var text = $el.text();
58 |             if (validations.trim) text = text.trim();
59 |             text.should.be.equal(validations.text);
60 |         }
61 | 
62 |         // Test attributes
63 |         _.each(validations.attributes, function(value, name) {
64 |             var attr = $el.attr(name);
65 |             should(attr).be.ok();
66 |             attr.should.be.equal(value);
67 |         });
68 |     });
69 | });
70 | 


--------------------------------------------------------------------------------
/test/books/basic/README.md:
--------------------------------------------------------------------------------
1 | # Readme
2 | 
3 | Default description for the book.
4 | 


--------------------------------------------------------------------------------
/test/books/basic/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 


--------------------------------------------------------------------------------
/test/books/config-js/README.md:
--------------------------------------------------------------------------------
1 | # Readme
2 | 


--------------------------------------------------------------------------------
/test/books/config-js/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 


--------------------------------------------------------------------------------
/test/books/config-js/book.js:
--------------------------------------------------------------------------------
1 | module.exports = {
2 |     "title": "js-config"
3 | };
4 | 


--------------------------------------------------------------------------------
/test/books/config-json/README.md:
--------------------------------------------------------------------------------
1 | # Readme
2 | 


--------------------------------------------------------------------------------
/test/books/config-json/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 


--------------------------------------------------------------------------------
/test/books/config-json/book.json:
--------------------------------------------------------------------------------
1 | {
2 |     "title": "json-config"
3 | }
4 | 


--------------------------------------------------------------------------------
/test/books/conrefs/README.md:
--------------------------------------------------------------------------------
 1 | # Readme
 2 | 
 3 | <p id="test-plugin-block-shortcuts-1">$$test_block1$$</p>
 4 | <p id="test-plugin-block-shortcuts-2">{% include "./block.md" %}</p>
 5 | 
 6 | ### Relative
 7 | 
 8 | <p id="t1">{% include "./hello.md" %}</p>
 9 | <p id="t2">{% include "/hello.md" %}</p>
10 | 
11 | ### Git
12 | 
13 | <p id="t3">{% include "git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test.md" %}</p>
14 | <p id="t4">{% include "git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test2.md" %}</p>
15 | <p id="t5">{% include "git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test3.md" %}</p>
16 | 


--------------------------------------------------------------------------------
/test/books/conrefs/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 


--------------------------------------------------------------------------------
/test/books/conrefs/block.md:
--------------------------------------------------------------------------------
1 | $$test_block2$$
2 | 


--------------------------------------------------------------------------------
/test/books/conrefs/hello.md:
--------------------------------------------------------------------------------
1 | Hello World
2 | 


--------------------------------------------------------------------------------
/test/books/glossary/GLOSSARY.md:
--------------------------------------------------------------------------------
 1 | # Glossary
 2 | 
 3 | ## test
 4 | 
 5 | Just a simple and easy to understand test.
 6 | 
 7 | ## hakunamatata
 8 | 
 9 | This word is not present in the content.
10 | 
11 | ## test long
12 | 
13 | This is a test with a longer text that the first entry to test order.
14 | 


--------------------------------------------------------------------------------
/test/books/glossary/README.md:
--------------------------------------------------------------------------------
 1 | # Readme
 2 | 
 3 | The word test should be replaced by a glossary link.
 4 | 
 5 | ```
 6 | But the word test should not be replaced in code blocks
 7 | ```
 8 | 
 9 | The two words test long should be replaced by the correct glossary links.
10 | 
11 | 


--------------------------------------------------------------------------------
/test/books/glossary/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 
3 | * [Page](folder/PAGE.md)
4 | 


--------------------------------------------------------------------------------
/test/books/glossary/folder/PAGE.md:
--------------------------------------------------------------------------------
1 | # Page
2 | 
3 | Just a page in a sub-directory to test relative link to glossary.
4 | 


--------------------------------------------------------------------------------
/test/books/headings/README.md:
--------------------------------------------------------------------------------
1 | # Hello World
2 | 
3 | ## Hello {#hello-custom}
4 | 


--------------------------------------------------------------------------------
/test/books/headings/SUMMARY.md:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/lwdgit/gitbook/7ea236981098f287dab5fa84c1e471217e414af7/test/books/headings/SUMMARY.md


--------------------------------------------------------------------------------
/test/books/highlight/README.md:
--------------------------------------------------------------------------------
 1 | # Readme
 2 | 
 3 | Block without language
 4 | 
 5 | ```
 6 | test 1
 7 | ```
 8 | 
 9 | Block with a language
10 | 
11 | ```lang
12 | test 2
13 | ```
14 | 
15 | Inline code: `test 3`
16 | Inline code with html: `<test>`


--------------------------------------------------------------------------------
/test/books/highlight/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 


--------------------------------------------------------------------------------
/test/books/images/README.md:
--------------------------------------------------------------------------------
 1 | # Tests for Images
 2 | 
 3 | # SVG relative image
 4 | 
 5 | 
 6 | ### Convert SVG to PNG
 7 | ![test.svg](test.svg)
 8 | 
 9 | ### Should only convert it once
10 | ![test.svg](test.svg)
11 | 
12 | ### Download remote images
13 | ![remote image](http://upload.wikimedia.org/wikipedia/commons/b/b0/NewTux.svg)
14 | 
15 | ### Remote images with same filename
16 | ![youtube1](http://img.youtube.com/vi/9bZkp7q19f0/0.jpg)
17 | ![youtube2](http://img.youtube.com/vi/IkV2HQLAKHY/0.jpg)
18 | 
19 | 


--------------------------------------------------------------------------------
/test/books/images/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 
3 | * [Page](./folder/PAGE.md)
4 | 


--------------------------------------------------------------------------------
/test/books/images/folder/PAGE.md:
--------------------------------------------------------------------------------
1 | ### Images from other folder
2 | ![test.svg](../test.svg)
3 | 
4 | 


--------------------------------------------------------------------------------
/test/books/images/test.svg:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1 Tiny//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-tiny.dtd">
 3 | <svg version="1.1" baseProfile="tiny" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" id="svg-root" width="100%" height="100%" viewBox="0 0 480 360">
 4 |     <title id="test-title">basic SVG tiny doc</title>
 5 |     <g id="test-body-content">
 6 |         <text font-family="Arial" font-size="14" text-anchor="middle" x="225" y="25">hello world</text>
 7 |     </g>
 8 |     <text id="revision" x="10" y="340" font-size="40" stroke="none" fill="black">Revision: 1.1</text>
 9 |     <rect id="test-frame" x="1" y="1" width="478" height="358" fill="none" stroke="#000000"/>
10 | </svg>
11 | 
12 | 


--------------------------------------------------------------------------------
/test/books/init/.gitignore:
--------------------------------------------------------------------------------
1 | *
2 | !SUMMARY.md
3 | !.gitignore
4 | 


--------------------------------------------------------------------------------
/test/books/init/SUMMARY.md:
--------------------------------------------------------------------------------
 1 | # Summary
 2 | 
 3 | * [Hello](hello.md)
 4 | * [Hello 2](hello2.md)
 5 | * Hello 3
 6 |     * [Hello 4](hello3/hello4.md)
 7 |     * Hello 5
 8 |         * [Hello 6](hello3/hello5/hello6.md)
 9 | 
10 | 


--------------------------------------------------------------------------------
/test/books/languages/LANGS.md:
--------------------------------------------------------------------------------
1 | # Language
2 | 
3 | * [English](en)
4 | * [French](fr)
5 | 


--------------------------------------------------------------------------------
/test/books/languages/README.md:
--------------------------------------------------------------------------------
1 | # Readme
2 | 


--------------------------------------------------------------------------------
/test/books/languages/en/README.md:
--------------------------------------------------------------------------------
1 | Hello
2 | 


--------------------------------------------------------------------------------
/test/books/languages/en/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 


--------------------------------------------------------------------------------
/test/books/languages/fr/README.md:
--------------------------------------------------------------------------------
1 | Bonjour
2 | 


--------------------------------------------------------------------------------
/test/books/languages/fr/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 


--------------------------------------------------------------------------------
/test/books/links/README.md:
--------------------------------------------------------------------------------
1 | # Readme
2 | 


--------------------------------------------------------------------------------
/test/books/links/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 
3 | * [Folder1](folder1/README.md)
4 | * [Folder2](folder2/README.md)


--------------------------------------------------------------------------------
/test/books/links/folder1/README.md:
--------------------------------------------------------------------------------
1 | # Folder 1
2 | 
3 | [Link to folder2](../folder2/README.md)
4 | 


--------------------------------------------------------------------------------
/test/books/links/folder2/README.md:
--------------------------------------------------------------------------------
1 | # Folder 2
2 | 


--------------------------------------------------------------------------------
/test/books/structure/README.adoc:
--------------------------------------------------------------------------------
1 | == Readme for the bookk
2 | 


--------------------------------------------------------------------------------
/test/books/structure/README.md:
--------------------------------------------------------------------------------
1 | # Readme for GitHub
2 | 


--------------------------------------------------------------------------------
/test/books/structure/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 


--------------------------------------------------------------------------------
/test/books/structure/book.json:
--------------------------------------------------------------------------------
1 | {
2 |     "structure": {
3 |         "readme": "README.adoc"
4 |     }
5 | }


--------------------------------------------------------------------------------
/test/books/structure/glossary.md:
--------------------------------------------------------------------------------
1 | # Glossary
2 | 
3 | ### Hello
4 | 
5 | Hello world
6 | 


--------------------------------------------------------------------------------
/test/books/style-print/README.md:
--------------------------------------------------------------------------------
1 | # Readme
2 | 
3 | Default description for the book.
4 | 


--------------------------------------------------------------------------------
/test/books/style-print/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 


--------------------------------------------------------------------------------
/test/books/style-print/styles/print.css:
--------------------------------------------------------------------------------
1 | body {
2 |     color: red;
3 | }
4 | 


--------------------------------------------------------------------------------
/test/books/summary/PAGE1.md:
--------------------------------------------------------------------------------
1 | # Page 1
2 | 


--------------------------------------------------------------------------------
/test/books/summary/README.md:
--------------------------------------------------------------------------------
1 | # Readme
2 | 


--------------------------------------------------------------------------------
/test/books/summary/SUMMARY.md:
--------------------------------------------------------------------------------
1 | # Summary
2 | 
3 | * [Page 1](./PAGE1.md)
4 | * [Page 2](./folder/PAGE2.md)
5 | * [Don't exists](./NOTFOUND.md)
6 | 


--------------------------------------------------------------------------------
/test/books/summary/folder/PAGE2.md:
--------------------------------------------------------------------------------
1 | # Page 2
2 | 


--------------------------------------------------------------------------------
/test/codehighlighting.js:
--------------------------------------------------------------------------------
 1 | var path = require('path');
 2 | var fs = require('fs');
 3 | 
 4 | var Plugin = require('../lib/plugin');
 5 | var PLUGINS_ROOT = path.resolve(__dirname, 'plugins');
 6 | 
 7 | describe('Code Highlighting', function () {
 8 |     var book, PAGE;
 9 | 
10 |     before(function() {
11 |         return books.generate('highlight', 'website', {
12 |             prepare: function(_book) {
13 |                 book = _book;
14 | 
15 |                 var plugin = new Plugin(book, 'replace_highlight');
16 |                 plugin.load('./replace_highlight', PLUGINS_ROOT);
17 | 
18 |                 book.plugins.load(plugin);
19 |             }
20 |         })
21 |         .then(function() {
22 |             PAGE = fs.readFileSync(
23 |                 path.join(book.options.output, 'index.html'),
24 |                 { encoding: 'utf-8' }
25 |             );
26 |         });
27 |     });
28 | 
29 |     it('should correctly replace highlighting', function() {
30 |         PAGE.should.be.html({
31 |             'code': {
32 |                 index: 0,
33 |                 text: 'code_test 1\n_code'
34 |             }
35 |         });
36 |     });
37 | 
38 |     it('should correctly replace highlighting with language', function() {
39 |         PAGE.should.be.html({
40 |             'code': {
41 |                 index: 1,
42 |                 text: 'lang_test 2\n_lang'
43 |             }
44 |         });
45 |     });
46 | 
47 |     it('should correctly replace highlighting for inline code', function() {
48 |         PAGE.should.be.html({
49 |             'code': {
50 |                 index: 2,
51 |                 text: 'code_test 3_code'
52 |             }
53 |         });
54 |     });
55 | 
56 |     it('should correctly replace highlighting for inline code with html tags', function() {
57 |         PAGE.should.be.html({
58 |             'code': {
59 |                 index: 3,
60 |                 text: 'code_<test>_code'
61 |             }
62 |         });
63 |     });
64 | });
65 | 
66 | 


--------------------------------------------------------------------------------
/test/configuration.js:
--------------------------------------------------------------------------------
 1 | describe('Configuration', function () {
 2 |     it('should extract default title from README', function() {
 3 |         return books.parse('basic')
 4 |             .then(function(book) {
 5 |                 book.options.title.should.be.equal('Readme');
 6 |             });
 7 |     });
 8 | 
 9 |     it('should extract default description from README', function() {
10 |         return books.parse('basic')
11 |             .then(function(book) {
12 |                 book.options.description.should.be.equal('Default description for the book.');
13 |             });
14 |     });
15 | 
16 |     it('should correctly load from json (book.json)', function() {
17 |         return books.parse('config-json')
18 |             .then(function(book) {
19 |                 book.options.title.should.be.equal('json-config');
20 |             });
21 |     });
22 | 
23 |     it('should correctly load from JavaScript (book.js)', function() {
24 |         return books.parse('config-js')
25 |             .then(function(book) {
26 |                 book.options.title.should.be.equal('js-config');
27 |             });
28 |     });
29 | 
30 |     it('should provide configuration on book.config.get', function() {
31 |         return books.parse('basic')
32 |             .then(function(book) {
33 |                 book.config.get('description').should.be.equal('Default description for the book.');
34 |                 book.getConfig('description').should.be.equal('Default description for the book.');
35 |             });
36 |     });
37 | });
38 | 


--------------------------------------------------------------------------------
/test/conrefs.js:
--------------------------------------------------------------------------------
 1 | var fs = require('fs');
 2 | var path = require('path');
 3 | 
 4 | describe('ConRefs', function () {
 5 |     var book, readme;
 6 | 
 7 |     before(function() {
 8 |         return books.generate('conrefs', 'website')
 9 |             .then(function(_book) {
10 |                 book = _book;
11 | 
12 |                 readme = fs.readFileSync(
13 |                     path.join(book.options.output, 'index.html'),
14 |                     { encoding: 'utf-8' }
15 |                 );
16 |             });
17 |     });
18 | 
19 |     it('should handle local references', function() {
20 |         readme.should.be.html({
21 |             '.page-inner p#t1': {
22 |                 count: 1,
23 |                 text: 'Hello World',
24 |                 trim: true
25 |             }
26 |         });
27 |     });
28 | 
29 |     it('should handle local references with absolute paths', function() {
30 |         readme.should.be.html({
31 |             '.page-inner p#t2': {
32 |                 count: 1,
33 |                 text: 'Hello World',
34 |                 trim: true
35 |             }
36 |         });
37 |     });
38 | 
39 |     it('should correctly include file from git reference', function() {
40 |         readme.should.be.html({
41 |             '.page-inner p#t3': {
42 |                 count: 1,
43 |                 text: 'Hello from git',
44 |                 trim: true
45 |             }
46 |         });
47 |     });
48 | 
49 |     it('should correctly handle deep include in git reference', function() {
50 |         readme.should.be.html({
51 |             '.page-inner p#t4': {
52 |                 count: 1,
53 |                 text: 'First Hello. Hello from git',
54 |                 trim: true
55 |             }
56 |         });
57 |     });
58 | 
59 |     it('should correctly handle absolute include in git reference', function() {
60 |         readme.should.be.html({
61 |             '.page-inner p#t5': {
62 |                 count: 1,
63 |                 text: 'First Hello. Hello from git',
64 |                 trim: true
65 |             }
66 |         });
67 |     });
68 | });
69 | 


--------------------------------------------------------------------------------
/test/ebook.js:
--------------------------------------------------------------------------------
 1 | var fs = require('fs');
 2 | var path = require('path');
 3 | 
 4 | describe('eBook generator', function () {
 5 |     describe('Basic Book', function() {
 6 |         var book;
 7 | 
 8 |         before(function() {
 9 |             return books.generate('basic', 'ebook')
10 |                 .then(function(_book) {
11 |                     book = _book;
12 |                 });
13 |         });
14 | 
15 |         it('should correctly output a SUMMARY.html', function() {
16 |             book.should.have.file('SUMMARY.html');
17 |         });
18 | 
19 |         it('should correctly copy assets', function() {
20 |             book.should.have.file('gitbook');
21 |             book.should.have.file('gitbook/ebook.css');
22 |         });
23 | 
24 |         it('should not copy website assets', function() {
25 |             book.should.not.have.file('gitbook/style.css');
26 |         });
27 |     });
28 | 
29 |     describe('Custom styles', function() {
30 |         var book;
31 | 
32 |         before(function() {
33 |             return books.generate('style-print', 'ebook')
34 |                 .then(function(_book) {
35 |                     book = _book;
36 |                 });
37 |         });
38 | 
39 |         it('should correctly copy print.css', function() {
40 |             book.should.have.file('styles');
41 |             book.should.have.file('styles/print.css');
42 |         });
43 | 
44 |         it('should remove default print.css', function() {
45 |             var PAGE = fs.readFileSync(
46 |                 path.join(book.options.output, 'index.html'),
47 |                 { encoding: 'utf-8' }
48 |             );
49 | 
50 |             // There are 2 styles (one from plugin-highlight and the new style)
51 |             PAGE.should.be.html({
52 |                 'link': {
53 |                     count: 2
54 |                 }
55 |             });
56 | 
57 |             PAGE.should.be.html({
58 |                 'link[href=\'./styles/print.css\']': {
59 |                     count: 1
60 |                 }
61 |             });
62 | 
63 |             PAGE.should.be.html({
64 |                 'link[href="gitbook/plugins/gitbook-plugin-highlight/ebook.css"]': {
65 |                     count: 1
66 |                 }
67 |             });
68 |         });
69 |     });
70 | });
71 | 


--------------------------------------------------------------------------------
/test/format.js:
--------------------------------------------------------------------------------
 1 | describe('Formatting', function () {
 2 |     it('should provide formatting with book.formatString', function() {
 3 |         return books.parse('basic')
 4 |         .then(function(book) {
 5 |             return book.formatString('markdown', 'this is a **test**');
 6 |         })
 7 |         .then(function(content) {
 8 |             content.should.equal('<p>this is a <strong>test</strong></p>\n');
 9 |         });
10 |     });
11 | });
12 | 


--------------------------------------------------------------------------------
/test/git.js:
--------------------------------------------------------------------------------
 1 | var should = require("should");
 2 | var git = require("../lib/utils/git");
 3 | 
 4 | describe("GIT parser and getter", function () {
 5 |     it("should correctly parse an https url", function() {
 6 |         var parts = git.parseUrl("git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test.md");
 7 | 
 8 |         should.exist(parts);
 9 |         parts.host.should.be.equal("https://gist.github.com/69ea4542e4c8967d2fa7.git");
10 |         parts.ref.should.be.equal("master");
11 |         parts.filepath.should.be.equal("test.md");
12 |     });
13 | 
14 |     it("should correctly parse an https url with a reference", function() {
15 |         var parts = git.parseUrl("git+https://gist.github.com/69ea4542e4c8967d2fa7.git/test.md#0.1.2");
16 | 
17 |         should.exist(parts);
18 |         parts.host.should.be.equal("https://gist.github.com/69ea4542e4c8967d2fa7.git");
19 |         parts.ref.should.be.equal("0.1.2");
20 |         parts.filepath.should.be.equal("test.md");
21 |     });
22 | 
23 |     it("should correctly parse an ssh url", function() {
24 |         var parts = git.parseUrl("git+git@github.com:GitbookIO/gitbook.git/directory/README.md#e1594cde2c32e4ff48f6c4eff3d3d461743d74e1");
25 | 
26 |         should.exist(parts);
27 |         parts.host.should.be.equal("git@github.com:GitbookIO/gitbook.git");
28 |         parts.ref.should.be.equal("e1594cde2c32e4ff48f6c4eff3d3d461743d74e1");
29 |         parts.filepath.should.be.equal("directory/README.md");
30 |     });
31 | });
32 | 


--------------------------------------------------------------------------------
/test/glossary.js:
--------------------------------------------------------------------------------
 1 | var fs = require("fs");
 2 | var path = require("path");
 3 | 
 4 | describe("Glossary", function () {
 5 |     describe("Parsing", function() {
 6 |         var book;
 7 | 
 8 |         before(function() {
 9 |             return books.parse("glossary")
10 |                 .then(function(_book) {
11 |                     book = _book;
12 |                 });
13 |         });
14 | 
15 |         it("should correctly list items", function() {
16 |             book.should.have.property("glossary");
17 |             book.glossary.should.have.lengthOf(3);
18 |         });
19 |     });
20 | 
21 |     describe("Generation", function() {
22 |         var book;
23 | 
24 |         before(function() {
25 |             return books.generate("glossary", "website")
26 |                 .then(function(_book) {
27 |                     book = _book;
28 |                 });
29 |         });
30 | 
31 |         it("should correctly generate a GLOSSARY.html", function() {
32 |             book.should.have.file("GLOSSARY.html");
33 |         });
34 | 
35 |         describe("Page Integration", function() {
36 |             var readme, page;
37 | 
38 |             before(function() {
39 |                 readme = fs.readFileSync(
40 |                     path.join(book.options.output, "index.html"),
41 |                     { encoding: "utf-8" }
42 |                 );
43 |                 page = fs.readFileSync(
44 |                     path.join(book.options.output, "folder/PAGE.html"),
45 |                     { encoding: "utf-8" }
46 |                 );
47 |             });
48 | 
49 |             it("should correctly replaced terms by links", function() {
50 |                 readme.should.be.html({
51 |                     ".page-inner a[href=\"GLOSSARY.html#test\"]": {
52 |                         count: 1,
53 |                         text: "test",
54 |                         attributes: {
55 |                             title: "Just a simple and easy to understand test."
56 |                         }
57 |                     }
58 |                 });
59 |             });
60 | 
61 |             it("should correctly replaced terms by links (relative)", function() {
62 |                 page.should.be.html({
63 |                     ".page-inner a[href=\"../GLOSSARY.html#test\"]": {
64 |                         count: 1
65 |                     }
66 |                 });
67 |             });
68 | 
69 |             it("should not replace terms in codeblocks", function() {
70 |                 readme.should.be.html({
71 |                     ".page-inner code a": {
72 |                         count: 0
73 |                     }
74 |                 });
75 |             });
76 | 
77 |             it("should correctly select the longest term", function() {
78 |                 readme.should.be.html({
79 |                     ".page-inner a[href=\"GLOSSARY.html#test_long\"]": {
80 |                         count: 1,
81 |                         text: "test long"
82 |                     }
83 |                 });
84 |             });
85 |         });
86 |     });
87 | });
88 | 


--------------------------------------------------------------------------------
/test/heading.js:
--------------------------------------------------------------------------------
 1 | var path = require('path');
 2 | var fs = require('fs');
 3 | 
 4 | describe('Headings', function () {
 5 |     var book, PAGE;
 6 | 
 7 |     before(function() {
 8 |         return books.generate('headings', 'website')
 9 |         .then(function(_book) {
10 |             book = _book;
11 | 
12 |             PAGE = fs.readFileSync(
13 |                 path.join(book.options.output, 'index.html'),
14 |                 { encoding: 'utf-8' }
15 |             );
16 |         });
17 |     });
18 | 
19 |     describe('IDs', function() {
20 |         it('should correctly generate an ID', function() {
21 |             PAGE.should.be.html({
22 |                 'h1#hello-world': {
23 |                     count: 1
24 |                 }
25 |             });
26 |         });
27 | 
28 |         it('should correctly accept custom ID', function() {
29 |             PAGE.should.be.html({
30 |                 'h2#hello-custom': {
31 |                     count: 1
32 |                 }
33 |             });
34 |         });
35 |     });
36 | });
37 | 
38 | 


--------------------------------------------------------------------------------
/test/helper.js:
--------------------------------------------------------------------------------
 1 | var os = require('os');
 2 | var path = require('path');
 3 | var Q = require('q');
 4 | var _ = require('lodash');
 5 | 
 6 | var fsUtil = require('../lib/utils/fs');
 7 | var Book = require('../').Book;
 8 | var LOG_LEVELS = require('../').LOG_LEVELS;
 9 | 
10 | require('./assertions');
11 | 
12 | 
13 | var BOOKS = {};
14 | var TMPDIR = os.tmpdir();
15 | 
16 | 
17 | // Generate and return a book
18 | function generateBook(bookId, test, opts) {
19 |     opts = _.defaults(opts || {}, {
20 |         prepare: function() {}
21 |     });
22 | 
23 |     return parseBook(bookId, test, opts)
24 |     .then(function(book) {
25 | 
26 |         return Q(opts.prepare(book))
27 |         .then(function() {
28 |             return book.generate(test);
29 |         })
30 |         .thenResolve(book);
31 |     });
32 | }
33 | 
34 | // Generate and return a book
35 | function parseBook(bookId, test, opts) {
36 |     opts = _.defaults(opts || {}, {
37 |         testId: ''
38 |     });
39 | 
40 |     test = test || 'website';
41 |     var testId = [test, opts.testId].join('-');
42 | 
43 |     BOOKS[bookId] = BOOKS[bookId] || {};
44 |     if (BOOKS[bookId][testId]) return Q(BOOKS[bookId][testId]);
45 | 
46 |     BOOKS[bookId][testId] = new Book(path.resolve(__dirname, 'books', bookId), {
47 |         logLevel: LOG_LEVELS.DISABLED,
48 |         config: {
49 |             output: path.resolve(TMPDIR, bookId+'-'+testId)
50 |         }
51 |     });
52 | 
53 |     return BOOKS[bookId][testId].parse()
54 |     .then(function() {
55 |         return BOOKS[bookId][testId];
56 |     });
57 | }
58 | 
59 | 
60 | global.books = {
61 |     parse: parseBook,
62 |     generate: generateBook
63 | };
64 | 
65 | // Cleanup all tests
66 | after(function() {
67 |     return _.chain(BOOKS)
68 |         .map(function(types) {
69 |             return _.values(types);
70 |         })
71 |         .flatten()
72 |         .reduce(function(prev, book) {
73 |             return prev.then(function() {
74 |                 return fsUtil.remove(book.options.output);
75 |             });
76 |         }, Q())
77 |         .value();
78 | });
79 | 


--------------------------------------------------------------------------------
/test/images.js:
--------------------------------------------------------------------------------
 1 | var fs = require("fs");
 2 | var _ = require("lodash");
 3 | var path = require("path");
 4 | var cheerio = require("cheerio");
 5 | 
 6 | describe("Images", function () {
 7 |     var book, readme, $, $img, srcs;
 8 | 
 9 |     before(function() {
10 |         return books.generate("images", "ebook")
11 |             .then(function(_book) {
12 |                 book = _book;
13 | 
14 |                 readme = fs.readFileSync(
15 |                     path.join(book.options.output, "index.html"),
16 |                     { encoding: "utf-8" }
17 |                 );
18 |                 $ = cheerio.load(readme);
19 |                 $img = $("img");
20 |                 srcs = $img.map(function() {
21 |                     return $(this).attr("src");
22 |                 });
23 |             });
24 |     });
25 | 
26 |     it("should detect all images", function() {
27 |         _.uniq(srcs).should.have.lengthOf(4);
28 |     });
29 | 
30 |     it("should keep image tags", function() {
31 |         srcs.should.have.lengthOf(5);
32 |     });
33 | 
34 |     it("should not have .svg files", function() {
35 |         _.each(srcs, function(src) {
36 |             path.extname(src).should.not.equal(".svg");
37 |         });
38 |     });
39 | 
40 |     it("should correctly convert svg images to png", function() {
41 |         _.each(srcs, function(src) {
42 |             book.should.have.file(src);
43 |         });
44 |     });
45 | 
46 |     it("should handle relative paths", function() {
47 |         var PAGE = fs.readFileSync(
48 |             path.join(book.options.output, "folder/PAGE.html"),
49 |             { encoding: "utf-8" }
50 |         );
51 | 
52 |         PAGE.should.be.html({
53 |             "img[src=\"../test.png\"]": {
54 |                 count: 1
55 |             }
56 |         });
57 |     });
58 | });
59 | 


--------------------------------------------------------------------------------
/test/init.js:
--------------------------------------------------------------------------------
 1 | var fs = require('fs');
 2 | var path = require('path');
 3 | var should = require('should');
 4 | 
 5 | var Book = require('../').Book;
 6 | var LOG_LEVELS = require('../').LOG_LEVELS;
 7 | 
 8 | describe('Init Books', function () {
 9 |     var initRoot;
10 | 
11 |     before(function() {
12 |         initRoot = path.resolve(__dirname, 'books/init');
13 |         return Book.init(initRoot, {
14 |             logLevel: LOG_LEVELS.DISABLED
15 |         });
16 |     });
17 | 
18 |     it('should create all chapters', function() {
19 |         should(fs.existsSync(path.resolve(initRoot, 'hello.md'))).be.ok();
20 |         should(fs.existsSync(path.resolve(initRoot, 'hello2.md'))).be.ok();
21 |         should(fs.existsSync(path.resolve(initRoot, 'hello3/hello4.md'))).be.ok();
22 |         should(fs.existsSync(path.resolve(initRoot, 'hello3/hello5/hello6.md'))).be.ok();
23 |     });
24 | });
25 | 


--------------------------------------------------------------------------------
/test/json.js:
--------------------------------------------------------------------------------
 1 | var fs = require('fs');
 2 | var path = require('path');
 3 | 
 4 | describe('JSON generator', function () {
 5 |     describe('Basic Book', function() {
 6 |         var book;
 7 | 
 8 |         before(function() {
 9 |             return books.generate('basic', 'json')
10 |                 .then(function(_book) {
11 |                     book = _book;
12 |                 });
13 |         });
14 | 
15 |         it('should correctly output a README.json', function() {
16 |             book.should.have.file('README.json');
17 |         });
18 | 
19 |         it('should output a valid json', function() {
20 |             book.should.have.jsonfile('README.json');
21 |         });
22 | 
23 |         describe('Page Format', function() {
24 |             var page;
25 | 
26 |             before(function() {
27 |                 page = JSON.parse(
28 |                     fs.readFileSync(
29 |                         path.join(book.options.output, 'README.json'),
30 |                         { encoding: 'utf-8' }
31 |                     )
32 |                 );
33 |             });
34 | 
35 |             it('should contains valid section', function() {
36 |                 page.should.have.property('sections').with.lengthOf(1);
37 |                 page.sections[0].should.have.property('content').which.is.a.String();
38 |                 page.sections[0].should.have.property('type', 'normal');
39 |             });
40 | 
41 |             it('should contains valid progress', function() {
42 |                 page.should.have.property('progress');
43 |                 page.progress.should.have.property('chapters').with.lengthOf(1);
44 |                 page.progress.should.have.property('current');
45 |             });
46 | 
47 |             it('should contains no languages', function() {
48 |                 page.should.have.property('langs').with.lengthOf(0);
49 |             });
50 |         });
51 |     });
52 | 
53 |     describe('Multilingual Book', function() {
54 |         var book;
55 | 
56 |         before(function() {
57 |             return books.generate('languages', 'json')
58 |                 .then(function(_book) {
59 |                     book = _book;
60 |                 });
61 |         });
62 | 
63 |         it('should correctly output READMEs', function() {
64 |             book.should.have.file('README.json');
65 |             book.should.have.file('en/README.json');
66 |             book.should.have.file('fr/README.json');
67 |         });
68 | 
69 |         it('should output valid json', function() {
70 |             book.should.have.jsonfile('README.json');
71 |             book.should.have.jsonfile('en/README.json');
72 |             book.should.have.jsonfile('fr/README.json');
73 |         });
74 | 
75 |         describe('Page Format', function() {
76 |             var page;
77 | 
78 |             before(function() {
79 |                 page = JSON.parse(
80 |                     fs.readFileSync(
81 |                         path.join(book.options.output, 'README.json'),
82 |                         { encoding: 'utf-8' }
83 |                     )
84 |                 );
85 |             });
86 | 
87 |             it('should contains no languages', function() {
88 |                 page.should.have.property('langs').with.lengthOf(2);
89 |             });
90 |         });
91 |     });
92 | });
93 | 


--------------------------------------------------------------------------------
/test/languages.js:
--------------------------------------------------------------------------------
 1 | describe("Languages", function () {
 2 |     describe("Parsing", function() {
 3 |         var book;
 4 | 
 5 |         before(function() {
 6 |             return books.parse("languages")
 7 |                 .then(function(_book) {
 8 |                     book = _book;
 9 |                 });
10 |         });
11 | 
12 |         it("should correctly list languages", function() {
13 |             book.should.have.property("books");
14 |             book.books.should.have.lengthOf(2);
15 | 
16 |             book.books[0].options.language.should.be.equal("en");
17 |             book.books[1].options.language.should.be.equal("fr");
18 |         });
19 |     });
20 | 
21 |     describe("Generation", function() {
22 |         var book;
23 | 
24 |         before(function() {
25 |             return books.generate("languages", "website")
26 |                 .then(function(_book) {
27 |                     book = _book;
28 |                 });
29 |         });
30 | 
31 |         it("should correctly create books", function() {
32 |             book.should.have.file("index.html");
33 |             book.should.have.file("en/index.html");
34 |             book.should.have.file("fr/index.html");
35 |         });
36 |     });
37 | });
38 | 


--------------------------------------------------------------------------------
/test/links.js:
--------------------------------------------------------------------------------
 1 | var fs = require("fs");
 2 | var path = require("path");
 3 | var cheerio = require("cheerio");
 4 | 
 5 | var links = require("../lib/utils/links");
 6 | 
 7 | describe("Links", function () {
 8 |     it("should correctly test external links", function() {
 9 |         links.isExternal("http://google.fr").should.be.exactly(true);
10 |         links.isExternal("https://google.fr").should.be.exactly(true);
11 |         links.isExternal("test.md").should.be.exactly(false);
12 |         links.isExternal("folder/test.md").should.be.exactly(false);
13 |         links.isExternal("/folder/test.md").should.be.exactly(false);
14 |     });
15 | 
16 |     it("should correctly detect anchor links", function() {
17 |         links.isAnchor("#test").should.be.exactly(true);
18 |         links.isAnchor(" #test").should.be.exactly(true);
19 |         links.isAnchor("https://google.fr#test").should.be.exactly(false);
20 |         links.isAnchor("test.md#test").should.be.exactly(false);
21 |     });
22 | 
23 |     describe("toAbsolute", function() {
24 |         it("should correctly transform as absolute", function() {
25 |             links.toAbsolute("http://google.fr").should.be.equal("http://google.fr");
26 |             links.toAbsolute("test.md", "./", "./").should.be.equal("test.md");
27 |             links.toAbsolute("folder/test.md", "./", "./").should.be.equal("folder/test.md");
28 |         });
29 | 
30 |         it("should correctly handle windows path", function() {
31 |             links.toAbsolute("folder\\test.md", "./", "./").should.be.equal("folder/test.md");
32 |         });
33 | 
34 |         it("should correctly handle absolute path", function() {
35 |             links.toAbsolute("/test.md", "./", "./").should.be.equal("test.md");
36 |             links.toAbsolute("/test.md", "test", "test").should.be.equal("../test.md");
37 |             links.toAbsolute("/sub/test.md", "test", "test").should.be.equal("../sub/test.md");
38 |         });
39 |     });
40 | 
41 |     describe("page", function() {
42 |         var book;
43 | 
44 |         before(function() {
45 |             return books.generate("links", "website")
46 |                 .then(function(_book) {
47 |                     book = _book;
48 |                 });
49 |         });
50 | 
51 |         it("should correctly replace relative links", function() {
52 |             var readme = fs.readFileSync(
53 |                 path.join(book.options.output, "folder1/index.html"),
54 |                 { encoding: "utf-8" }
55 |             );
56 |             var $ = cheerio.load(readme);
57 |             var $a = $(".page-inner a");
58 | 
59 |             $a.attr("href").should.be.exactly("../folder2/index.html");
60 |         });
61 |     });
62 | 
63 | });
64 | 


--------------------------------------------------------------------------------
/test/navigation.js:
--------------------------------------------------------------------------------
 1 | var should = require("should");
 2 | 
 3 | describe("Navigation", function () {
 4 |     var book;
 5 | 
 6 |     before(function() {
 7 |         return books.parse("summary")
 8 |             .then(function(_book) {
 9 |                 book = _book;
10 |             });
11 |     });
12 | 
13 |     it("should correctly parse navigation as a map", function() {
14 |         book.should.have.property("navigation");
15 |         book.navigation.should.have.property("README.md");
16 |         book.navigation.should.have.property("README.md");
17 |     });
18 | 
19 |     it("should correctly include filenames", function() {
20 |         book.navigation.should.have.property("README.md");
21 |         book.navigation.should.have.property("PAGE1.md");
22 |         book.navigation.should.have.property("folder/PAGE2.md");
23 |         book.navigation.should.not.have.property("NOTFOUND.md");
24 |     });
25 | 
26 |     it("should correctly detect next/prev for README", function() {
27 |         var README = book.navigation["README.md"];
28 | 
29 |         README.index.should.equal(0);
30 |         README.should.have.property("next");
31 |         should(README.prev).not.be.ok();
32 | 
33 |         README.next.should.have.property("path");
34 |         README.next.path.should.equal("PAGE1.md");
35 |     });
36 | 
37 |     it("should correctly detect next/prev a page", function() {
38 |         var PAGE = book.navigation["PAGE1.md"];
39 | 
40 |         PAGE.index.should.equal(1);
41 |         PAGE.should.have.property("next");
42 |         PAGE.should.have.property("prev");
43 | 
44 |         PAGE.prev.should.have.property("path");
45 |         PAGE.prev.path.should.equal("README.md");
46 | 
47 |         PAGE.next.should.have.property("path");
48 |         PAGE.next.path.should.equal("folder/PAGE2.md");
49 |     });
50 | 
51 |     it("should correctly detect next/prev for last page", function() {
52 |         var PAGE = book.navigation["folder/PAGE2.md"];
53 | 
54 |         PAGE.index.should.equal(2);
55 |         PAGE.should.have.property("prev");
56 |         should(PAGE.next).not.be.ok();
57 | 
58 |         PAGE.prev.should.have.property("path");
59 |         PAGE.prev.path.should.equal("PAGE1.md");
60 |     });
61 | });
62 | 


--------------------------------------------------------------------------------
/test/plugins/blocks/index.js:
--------------------------------------------------------------------------------
 1 | var assert = require("assert");
 2 | 
 3 | module.exports = {
 4 |     blocks: {
 5 |         "test": {
 6 |             shortcuts: {
 7 |                 parsers:  ["markdown"],
 8 |                 start: "$$",
 9 |                 end: "$$"
10 |             },
11 |             process: function(blk) {
12 |                 return "test"+blk.body+"test";
13 |             }
14 |         },
15 |         "test2": {
16 |             end: "endtest2end",
17 |             process: function(blk) {
18 |                 return "test2"+blk.body+"test2";
19 |             }
20 |         },
21 |         "test3join": {
22 |             blocks: [
23 |                 "also"
24 |             ],
25 |             process: function(blk) {
26 |                 return [blk.body, blk.blocks[0].body].join(blk.kwargs.separator);
27 |             }
28 |         },
29 |         "test4join": {
30 |             blocks: [
31 |                 "also", "finally"
32 |             ],
33 |             process: function(blk) {
34 |                 assert(blk.blocks.length, 2);
35 |                 assert(blk.blocks[0].name, "also");
36 |                 assert(blk.blocks[1].name, "finally");
37 |                 return [blk.body, blk.blocks[0].body, blk.blocks[1].body].join(blk.kwargs.separator);
38 |             }
39 |         },
40 |         "test5args": {
41 |             process: function(blk) {
42 |                 return "test5"+blk.args.join(",")+"test5";
43 |             }
44 |         },
45 |         "test5kwargs": {
46 |             process: function(blk) {
47 |                 var s = blk.args.join(",");
48 |                 for (var key in blk.kwargs) {
49 |                     s = s + ","+key+":"+blk.kwargs[key];
50 |                 }
51 | 
52 |                 return "test5"+s+"test5";
53 |             }
54 |         },
55 |         "test6context": {
56 |             process: function() {
57 |                 return "test6"+(this.ctx.name)+"test6";
58 |             }
59 |         },
60 |     }
61 | };


--------------------------------------------------------------------------------
/test/plugins/blocks/package.json:
--------------------------------------------------------------------------------
1 | {
2 |     "name": "gitbook-plugin-blocks",
3 |     "description": "Test blocks",
4 |     "main": "index.js",
5 |     "version": "0.0.1",
6 |     "engines": {
7 |         "gitbook": "*"
8 |     }
9 | }


--------------------------------------------------------------------------------
/test/plugins/config/index.js:
--------------------------------------------------------------------------------
1 | module.exports = {};
2 | 


--------------------------------------------------------------------------------
/test/plugins/config/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "gitbook-plugin-testconfig",
 3 |     "description": "Test plugin configuration",
 4 |     "main": "index.js",
 5 |     "version": "0.0.1",
 6 |     "engines": {
 7 |         "gitbook": "*"
 8 |     },
 9 |     "gitbook": {
10 |         "properties": {
11 |             "hello": {
12 |                 "type": "string",
13 |                 "default": "world"
14 |             },
15 |             "testRequired": {
16 |                 "type": "number",
17 |                 "required": true
18 |             }
19 |         }
20 |     }
21 | }


--------------------------------------------------------------------------------
/test/plugins/empty/index.js:
--------------------------------------------------------------------------------
1 | module.exports = {};


--------------------------------------------------------------------------------
/test/plugins/empty/package.json:
--------------------------------------------------------------------------------
1 | {
2 |     "name": "gitbook-plugin-empty",
3 |     "description": "Test empty plugin",
4 |     "main": "index.js",
5 |     "version": "0.0.1",
6 |     "engines": {
7 |         "gitbook": "*"
8 |     }
9 | }


--------------------------------------------------------------------------------
/test/plugins/filters/index.js:
--------------------------------------------------------------------------------
 1 | module.exports = {
 2 |     filters: {
 3 |         hello: function(text) {
 4 |             return "Hello "+text;
 5 |         },
 6 |         helloCtx: function(text) {
 7 |             return text+":"+this.book.root;
 8 |         }
 9 |     }
10 | };


--------------------------------------------------------------------------------
/test/plugins/filters/package.json:
--------------------------------------------------------------------------------
1 | {
2 |     "name": "gitbook-plugin-filters",
3 |     "description": "Test filters",
4 |     "main": "index.js",
5 |     "version": "0.0.1",
6 |     "engines": {
7 |         "gitbook": "*"
8 |     }
9 | }


--------------------------------------------------------------------------------
/test/plugins/invalid/index.js:
--------------------------------------------------------------------------------
1 | module.exports = {};


--------------------------------------------------------------------------------
/test/plugins/invalid/package.json:
--------------------------------------------------------------------------------
1 | {
2 |     "name": "gitbook-plugin-invalid",
3 |     "description": "Test invalid plugin",
4 |     "main": "index.js",
5 |     "version": "0.0.1",
6 |     "engines": {
7 |         "gitbook": "<2.0.0"
8 |     }
9 | }


--------------------------------------------------------------------------------
/test/plugins/replace_highlight/index.js:
--------------------------------------------------------------------------------
 1 | module.exports = {
 2 |     blocks: {
 3 |         "code": {
 4 |             process: function(blk) {
 5 |                 var lang = blk.kwargs.language || "code";
 6 | 
 7 |                 return {
 8 |                     body: lang+"_"+blk.body+"_"+lang,
 9 |                     html: false
10 |                 };
11 |             }
12 |         }
13 |     }
14 | };


--------------------------------------------------------------------------------
/test/plugins/replace_highlight/package.json:
--------------------------------------------------------------------------------
1 | {
2 |     "name": "gitbook-plugin-replace_highlight",
3 |     "description": "Test replacing default code highlighter",
4 |     "main": "index.js",
5 |     "version": "0.0.1",
6 |     "engines": {
7 |         "gitbook": "*"
8 |     }
9 | }


--------------------------------------------------------------------------------
/test/plugins/resources/index.js:
--------------------------------------------------------------------------------
 1 | module.exports = {
 2 |     website: {
 3 |         js: [
 4 |             "https://cdn.mathjax.org/mathjax/2.4-latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"
 5 |         ]
 6 |     },
 7 |     ebook: {
 8 |         css: [
 9 |             "test"
10 |         ]
11 |     }
12 | };
13 | 


--------------------------------------------------------------------------------
/test/plugins/resources/package.json:
--------------------------------------------------------------------------------
1 | {
2 |     "name": "gitbook-plugin-resources",
3 |     "description": "Test resources plugin",
4 |     "main": "index.js",
5 |     "version": "0.0.1",
6 |     "engines": {
7 |         "gitbook": "*"
8 |     }
9 | }


--------------------------------------------------------------------------------
/test/resolve.js:
--------------------------------------------------------------------------------
 1 | var path = require("path");
 2 | 
 3 | describe("Resolve Files", function () {
 4 |     var book;
 5 | 
 6 |     before(function() {
 7 |         return books.parse("basic")
 8 |             .then(function(_book) {
 9 |                 book = _book;
10 |             });
11 |     });
12 | 
13 |     describe("book.fileIsInBook", function() {
14 |         it("should return true for correct paths", function() {
15 |             book.fileIsInBook(path.join(book.root, "README.md")).should.equal(true);
16 |             book.fileIsInBook(path.join(book.root, "styles/website.css")).should.equal(true);
17 |         });
18 | 
19 |         it("should return true for root folder", function() {
20 |             book.fileIsInBook(path.join(book.root, "./")).should.equal(true);
21 |             book.fileIsInBook(book.root).should.equal(true);
22 |         });
23 | 
24 |         it("should return false for files out of scope", function() {
25 |             book.fileIsInBook(path.join(book.root, "../")).should.equal(false);
26 |             book.fileIsInBook("README.md").should.equal(false);
27 |             book.fileIsInBook(path.resolve(book.root, "../README.md")).should.equal(false);
28 |         });
29 | 
30 |         it("should correctly handle windows paths", function() {
31 |             book.fileIsInBook(path.join(book.root, "\\styles\\website.css")).should.equal(true);
32 |         });
33 |     });
34 | 
35 |     describe("book.resolve", function() {
36 |         it("should resolve a file to its absolute path", function() {
37 |             book.resolve("README.md").should.equal(path.resolve(book.root, "README.md"));
38 |             book.resolve("website/README.md").should.equal(path.resolve(book.root, "website/README.md"));
39 |         });
40 | 
41 |         it("should correctly handle windows paths", function() {
42 |             book.resolve("styles\\website.css").should.equal(path.resolve(book.root, "styles\\website.css"));
43 |         });
44 | 
45 |         it("should correctly resolve all arguments", function() {
46 |             book.resolve("test", "hello", "..", "README.md").should.equal(path.resolve(book.root, "test/README.md"));
47 |         });
48 | 
49 |         it("should correctly resolve to root folder", function() {
50 |             book.resolve("test", "/README.md").should.equal(path.resolve(book.root, "README.md"));
51 |             book.resolve("test", "\\README.md").should.equal(path.resolve(book.root, "README.md"));
52 |         });
53 | 
54 |         it("should throw an error for file out of book", function() {
55 |             (function() {
56 |                 return book.resolve("../README.md");
57 |             }).should.throw();
58 |         });
59 |     });
60 | });
61 | 


--------------------------------------------------------------------------------
/test/structure.js:
--------------------------------------------------------------------------------
 1 | describe('Structure', function () {
 2 |     var book;
 3 | 
 4 |     before(function() {
 5 |         return books.parse('structure')
 6 |             .then(function(_book) {
 7 |                 book = _book;
 8 |             });
 9 |     });
10 | 
11 | 
12 |     it('should prioritize structure defined in book.json', function() {
13 |         book.readmeFile.should.equal('README.adoc');
14 |     });
15 | 
16 |     it('should be case incensitive', function() {
17 |         book.glossaryFile.should.equal('glossary.md');
18 |         book.glossary.should.have.lengthOf(1);
19 |     });
20 | });
21 | 


--------------------------------------------------------------------------------
/test/summary.js:
--------------------------------------------------------------------------------
 1 | var fs = require("fs");
 2 | var path = require("path");
 3 | 
 4 | describe("Summary", function () {
 5 |     describe("Parsing", function() {
 6 |         var book;
 7 | 
 8 |         before(function() {
 9 |             return books.parse("summary")
10 |                 .then(function(_book) {
11 |                     book = _book;
12 |                 });
13 |         });
14 | 
15 |         it("should correctly list items", function() {
16 |             book.should.have.property("summary");
17 |             book.summary.should.have.property("chapters");
18 |             book.summary.chapters.should.have.lengthOf(4);
19 |         });
20 | 
21 |         it("should correctly mark non-existant entries", function() {
22 |             book.summary.chapters[0].exists.should.have.equal(true);
23 |             book.summary.chapters[1].exists.should.have.equal(true);
24 |             book.summary.chapters[2].exists.should.have.equal(true);
25 |             book.summary.chapters[3].exists.should.have.equal(false);
26 |         });
27 |     });
28 | 
29 |     describe("Generation", function() {
30 |         var book;
31 | 
32 |         before(function() {
33 |             return books.generate("summary", "website")
34 |                 .then(function(_book) {
35 |                     book = _book;
36 |                 });
37 |         });
38 | 
39 |         it("should create files according to summary", function() {
40 |             book.should.have.file("index.html");
41 |             book.should.have.file("PAGE1.html");
42 |             book.should.have.file("folder/PAGE2.html");
43 |         });
44 | 
45 |         it("should correctly output summary", function() {
46 |             var PAGE = fs.readFileSync(
47 |                 path.join(book.options.output, "index.html"),
48 |                 { encoding: "utf-8" }
49 |             );
50 | 
51 |             PAGE.should.be.html({
52 |                 ".book-summary .chapter[data-level=\"0\"] a": {
53 |                     attributes: {
54 |                         href: "./index.html"
55 |                     }
56 |                 },
57 |                 ".book-summary .chapter[data-level=\"1\"] a": {
58 |                     attributes: {
59 |                         href: "./PAGE1.html"
60 |                     }
61 |                 },
62 |                 ".book-summary .chapter[data-level=\"2\"] a": {
63 |                     attributes: {
64 |                         href: "./folder/PAGE2.html"
65 |                     }
66 |                 }
67 |             });
68 |         });
69 |     });
70 | });
71 | 


--------------------------------------------------------------------------------
/test/templating.js:
--------------------------------------------------------------------------------
 1 | var pkg = require("../package.json");
 2 | 
 3 | describe("Templating", function () {
 4 |     var book;
 5 | 
 6 |     before(function() {
 7 |         return books.parse("basic")
 8 |             .then(function(_book) {
 9 |                 book = _book;
10 |             });
11 |     });
12 | 
13 |     var testTpl = function(str, args, options) {
14 |         return book.template.renderString(str, args, options)
15 |         .then(book.template.postProcess);
16 |     };
17 | 
18 |     describe("Context", function() {
19 |         it("should correctly have access to generator", function() {
20 |             return testTpl("{{ gitbook.generator }}")
21 |                 .then(function(content) {
22 |                     content.should.equal("website");
23 |                 });
24 |         });
25 | 
26 |         it("should correctly have access to gitbook version", function() {
27 |             return testTpl("{{ gitbook.version }}")
28 |                 .then(function(content) {
29 |                     content.should.equal(pkg.version.toString());
30 |                 });
31 |         });
32 |     });
33 | });
34 | 


--------------------------------------------------------------------------------
/test/website.js:
--------------------------------------------------------------------------------
 1 | describe('Website generator', function () {
 2 |     describe('Basic Book', function() {
 3 |         var book;
 4 | 
 5 |         before(function() {
 6 |             return books.generate('basic', 'website')
 7 |                 .then(function(_book) {
 8 |                     book = _book;
 9 |                 });
10 |         });
11 | 
12 |         it('should correctly output an index.html', function() {
13 |             book.should.have.file('index.html');
14 |         });
15 | 
16 |         it('should correctly copy assets', function() {
17 |             book.should.have.file('gitbook');
18 |             book.should.have.file('gitbook/app.js');
19 |             book.should.have.file('gitbook/style.css');
20 |         });
21 | 
22 |         it('should not copy ebook assets', function() {
23 |             book.should.not.have.file('gitbook/ebook.css');
24 |         });
25 |     });
26 | });
27 | 


--------------------------------------------------------------------------------
/theme/assets/ebook/ebook.css:
--------------------------------------------------------------------------------
1 | .section.glossary>h1,.section.toc>h1{text-align:center}.page .section b,.page .section dl dt,.page .section strong,.page .section table th{font-weight:700}.link-inherit,.link-inherit:focus,.link-inherit:hover{color:inherit}.hidden{display:none}.section.toc>ol{margin:0;padding:0}.section.toc li{list-style:none}.section.toc li .inner{display:block;border-bottom:1px dotted #eee;margin-bottom:4px}.section.toc li .inner a,.section.toc li .inner span{padding-right:5px;border-bottom:1px solid #fff;margin-bottom:-1px}.section.toc li .inner .page{float:right;padding-left:5px}.section.toc li ol{margin:0;padding:0 0 0 2em}.dir-rtl .section.toc li .inner .page{float:left}.dir-rtl .section.toc li ol{margin:0;padding:0 2em 0 0}.section.glossary .glossary-entry{margin-bottom:40px}.section.glossary .glossary-entry h2 a,.section.glossary .glossary-entry h2 a:hover{color:inherit;text-decoration:none}.page .section,body{color:#000;text-size-adjust:100%;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}.section.glossary .glossary-entry .glossary-index{list-style:none;margin:0;padding:0}.section.glossary .glossary-entry .glossary-index li{display:inline;margin:0 8px;white-space:nowrap}body{font-family:sans-serif}.page .section{display:block;word-wrap:break-word;overflow:hidden;line-height:1.6;-moz-text-size-adjust:100%}.page .section *{box-sizing:border-box;-webkit-box-sizing:border-box;font-size:inherit}.page .section>:first-child{margin-top:0!important}.page .section>:last-child{margin-bottom:0!important}.page .section blockquote,.page .section code,.page .section figure,.page .section img,.page .section pre,.page .section table,.page .section tr{page-break-inside:avoid}.page .section h2,.page .section h3,.page .section h4,.page .section h5,.page .section p{orphans:3;widows:3}.page .section h1,.page .section h2,.page .section h3,.page .section h4,.page .section h5{page-break-after:avoid}.page .section em{font-style:italic}.page .section blockquote,.page .section dl,.page .section ol,.page .section p,.page .section table,.page .section ul{margin-top:0;margin-bottom:.8em}.page .section a{color:#4183c4;text-decoration:none;background:0 0}.page .section a:active,.page .section a:focus,.page .section a:hover{outline:0;text-decoration:underline}.page .section img{border:0;max-width:100%}.page .section hr{height:4px;padding:0;margin:1.6em 0;overflow:hidden;background-color:#e7e7e7;border:none}.page .section hr:after,.page .section hr:before{display:table;content:" "}.page .section hr:after{clear:both}.page .section h1,.page .section h2,.page .section h3,.page .section h4,.page .section h5,.page .section h6{margin-top:1.2em;margin-bottom:.8em;font-weight:700}.page .section h1{font-size:2em}.page .section h2{font-size:1.75em}.page .section h3{font-size:1.5em}.page .section h4{font-size:1.25em}.page .section h5{font-size:1em}.page .section h6{font-size:1em;color:#777}.page .section code,.page .section pre{font-family:Consolas,"Liberation Mono",Menlo,Courier,monospace;direction:ltr;border:none;color:inherit}.page .section pre{overflow:auto;word-wrap:normal;margin:0 0 1.2em;padding:.85em 1em;background:#f7f7f7}.page .section pre>code{display:inline;max-width:initial;padding:0;margin:0;overflow:initial;line-height:inherit;font-size:.85em;white-space:pre;background:0 0}.page .section pre>code:after,.page .section pre>code:before{content:normal}.page .section code{padding:.2em;margin:0;font-size:.85em;background-color:#f7f7f7}.page .section code:after,.page .section code:before{letter-spacing:-.2em;content:"\00a0"}.page .section table{display:table;width:100%;border-collapse:collapse;border-spacing:0;overflow:auto}.page .section table td,.page .section table th{padding:6px 13px;border:1px solid #ddd}.page .section table tr{background-color:#fff;border-top:1px solid #ccc}.page .section table tr:nth-child(2n){background-color:#f8f8f8}.page .section ol,.page .section ul{padding:0 0 0 2em;margin:0 0 .8em}.page .section ol ol,.page .section ol ul,.page .section ul ol,.page .section ul ul{margin-top:0;margin-bottom:0}.page .section ol ol{list-style-type:lower-roman}.page .section blockquote{margin:0 0 .8em;padding:0 15px;color:#858585;border-left:4px solid #e5e5e5}.page .section blockquote:first-child{margin-top:0}.page .section blockquote:last-child{margin-bottom:0}.page .section dl{padding:0}.page .section dl dt{padding:0;margin-top:.8em;font-style:italic}.page .section dl dd{padding:0 .8em;margin-bottom:.8em}.page .section dd{margin-left:0}.page .book-chapter{display:none}


--------------------------------------------------------------------------------
/theme/assets/ebook/epub.css:
--------------------------------------------------------------------------------
1 | .section.glossary>h1,.section.toc>h1{text-align:center}.page .section b,.page .section dl dt,.page .section strong,.page .section table th{font-weight:700}.link-inherit,.link-inherit:focus,.link-inherit:hover{color:inherit}.hidden{display:none}.section.toc>ol{margin:0;padding:0}.section.toc li{list-style:none}.section.toc li .inner{display:block;border-bottom:1px dotted #eee;margin-bottom:4px}.section.toc li .inner a,.section.toc li .inner span{padding-right:5px;border-bottom:1px solid #fff;margin-bottom:-1px}.section.toc li .inner .page{float:right;padding-left:5px}.section.toc li ol{margin:0;padding:0 0 0 2em}.dir-rtl .section.toc li .inner .page{float:left}.dir-rtl .section.toc li ol{margin:0;padding:0 2em 0 0}.section.glossary .glossary-entry{margin-bottom:40px}.section.glossary .glossary-entry h2 a,.section.glossary .glossary-entry h2 a:hover{color:inherit;text-decoration:none}.page .section,body{color:#000;text-size-adjust:100%;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}.section.glossary .glossary-entry .glossary-index{list-style:none;margin:0;padding:0}.section.glossary .glossary-entry .glossary-index li{display:inline;margin:0 8px;white-space:nowrap}body{font-family:serif}.page .section{display:block;word-wrap:break-word;overflow:hidden;line-height:1.6;-moz-text-size-adjust:100%}.page .section *{box-sizing:border-box;-webkit-box-sizing:border-box;font-size:inherit}.page .section>:first-child{margin-top:0!important}.page .section>:last-child{margin-bottom:0!important}.page .section blockquote,.page .section code,.page .section figure,.page .section img,.page .section pre,.page .section table,.page .section tr{page-break-inside:avoid}.page .section h2,.page .section h3,.page .section h4,.page .section h5,.page .section p{orphans:3;widows:3}.page .section h1,.page .section h2,.page .section h3,.page .section h4,.page .section h5{page-break-after:avoid}.page .section em{font-style:italic}.page .section blockquote,.page .section dl,.page .section ol,.page .section p,.page .section table,.page .section ul{margin-top:0;margin-bottom:.8em}.page .section a{color:#4183c4;text-decoration:none;background:0 0}.page .section a:active,.page .section a:focus,.page .section a:hover{outline:0;text-decoration:underline}.page .section img{border:0;max-width:100%}.page .section hr{height:4px;padding:0;margin:1.6em 0;overflow:hidden;background-color:#e7e7e7;border:none}.page .section hr:after,.page .section hr:before{display:table;content:" "}.page .section hr:after{clear:both}.page .section h1,.page .section h2,.page .section h3,.page .section h4,.page .section h5,.page .section h6{margin-top:1.2em;margin-bottom:.8em;font-weight:700}.page .section h1{font-size:2em}.page .section h2{font-size:1.75em}.page .section h3{font-size:1.5em}.page .section h4{font-size:1.25em}.page .section h5{font-size:1em}.page .section h6{font-size:1em;color:#777}.page .section code,.page .section pre{font-family:Consolas,"Liberation Mono",Menlo,Courier,monospace;direction:ltr;border:none;color:inherit}.page .section pre{overflow:auto;word-wrap:normal;margin:0 0 1.2em;padding:.85em 1em;background:#f7f7f7}.page .section pre>code{display:inline;max-width:initial;padding:0;margin:0;overflow:initial;line-height:inherit;font-size:.85em;white-space:pre;background:0 0}.page .section pre>code:after,.page .section pre>code:before{content:normal}.page .section code{padding:.2em;margin:0;font-size:.85em;background-color:#f7f7f7}.page .section code:after,.page .section code:before{letter-spacing:-.2em;content:"\00a0"}.page .section table{display:table;width:100%;border-collapse:collapse;border-spacing:0;overflow:auto}.page .section table td,.page .section table th{padding:6px 13px;border:1px solid #ddd}.page .section table tr{background-color:#fff;border-top:1px solid #ccc}.page .section table tr:nth-child(2n){background-color:#f8f8f8}.page .section ol,.page .section ul{padding:0 0 0 2em;margin:0 0 .8em}.page .section ol ol,.page .section ol ul,.page .section ul ol,.page .section ul ul{margin-top:0;margin-bottom:0}.page .section ol ol{list-style-type:lower-roman}.page .section blockquote{margin:0 0 .8em;padding:0 15px;color:#858585;border-left:4px solid #e5e5e5}.page .section blockquote:first-child{margin-top:0}.page .section blockquote:last-child{margin-bottom:0}.page .section dl{padding:0}.page .section dl dt{padding:0;margin-top:.8em;font-style:italic}.page .section dl dd{padding:0 .8em;margin-bottom:.8em}.page .section dd{margin-left:0}.page .book-chapter{display:none}


--------------------------------------------------------------------------------
/theme/assets/ebook/mobi.css:
--------------------------------------------------------------------------------
1 | .section.glossary>h1,.section.toc>h1{text-align:center}.page .section,body{text-size-adjust:100%;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}.page .section b,.page .section dl dt,.page .section strong,.page .section table th{font-weight:700}.link-inherit,.link-inherit:focus,.link-inherit:hover{color:inherit}.hidden{display:none}.section.toc>ol{margin:0;padding:0}.section.toc li{list-style:none}.section.toc li .inner{display:block;border-bottom:1px dotted #eee;margin-bottom:4px}.section.toc li .inner a,.section.toc li .inner span{padding-right:5px;border-bottom:1px solid #fff;margin-bottom:-1px}.section.toc li .inner .page{float:right;padding-left:5px}.section.toc li ol{margin:0;padding:0 0 0 2em}.dir-rtl .section.toc li .inner .page{float:left}.dir-rtl .section.toc li ol{margin:0;padding:0 2em 0 0}.section.glossary .glossary-entry{margin-bottom:40px}.section.glossary .glossary-entry h2 a,.section.glossary .glossary-entry h2 a:hover{color:inherit;text-decoration:none}.section.glossary .glossary-entry .glossary-index{list-style:none;margin:0;padding:0}.section.glossary .glossary-entry .glossary-index li{display:inline;margin:0 8px;white-space:nowrap}body{font-family:serif;color:#000}.page .section{display:block;word-wrap:break-word;overflow:hidden;color:#000;line-height:1.6;-moz-text-size-adjust:100%}.page .section *{box-sizing:border-box;-webkit-box-sizing:border-box;font-size:inherit}.page .section>:first-child{margin-top:0!important}.page .section>:last-child{margin-bottom:0!important}.page .section blockquote,.page .section code,.page .section figure,.page .section img,.page .section pre,.page .section table,.page .section tr{page-break-inside:avoid}.page .section h2,.page .section h3,.page .section h4,.page .section h5,.page .section p{orphans:3;widows:3}.page .section h1,.page .section h2,.page .section h3,.page .section h4,.page .section h5{page-break-after:avoid}.page .section em{font-style:italic}.page .section blockquote,.page .section dl,.page .section ol,.page .section p,.page .section table,.page .section ul{margin-top:0;margin-bottom:.8em}.page .section a{color:#000;text-decoration:none;background:0 0}.page .section a:active,.page .section a:focus,.page .section a:hover{outline:0;text-decoration:underline}.page .section img{border:0;max-width:100%}.page .section hr{height:4px;padding:0;margin:1.6em 0;overflow:hidden;background-color:#e7e7e7;border:none}.page .section hr:after,.page .section hr:before{display:table;content:" "}.page .section hr:after{clear:both}.page .section h1,.page .section h2,.page .section h3,.page .section h4,.page .section h5,.page .section h6{margin-top:1.2em;margin-bottom:.8em;font-weight:700}.page .section h1{font-size:2em}.page .section h2{font-size:1.75em}.page .section h3{font-size:1.5em}.page .section h4{font-size:1.25em}.page .section h5{font-size:1em}.page .section h6{font-size:1em;color:#777}.page .section code,.page .section pre{font-family:Consolas,"Liberation Mono",Menlo,Courier,monospace;direction:ltr;border:none;color:inherit}.page .section pre{overflow:auto;word-wrap:normal;margin:0 0 1.2em;padding:.85em 1em;background:#f7f7f7}.page .section pre>code{display:inline;max-width:initial;padding:0;margin:0;overflow:initial;line-height:inherit;font-size:.85em;white-space:pre;background:0 0}.page .section pre>code:after,.page .section pre>code:before{content:normal}.page .section code{padding:.2em;margin:0;font-size:.85em;background-color:#f7f7f7}.page .section code:after,.page .section code:before{letter-spacing:-.2em;content:"\00a0"}.page .section table{display:table;width:100%;border-collapse:collapse;border-spacing:0;overflow:auto}.page .book-chapter,.page-toc li .inner span.page{display:none}.page .section table td,.page .section table th{padding:6px 13px;border:1px solid #ddd}.page .section table tr{background-color:#fff;border-top:1px solid #ccc}.page .section table tr:nth-child(2n){background-color:#f8f8f8}.page .section ol,.page .section ul{padding:0 0 0 2em;margin:0 0 .8em}.page .section ol ol,.page .section ol ul,.page .section ul ol,.page .section ul ul{margin-top:0;margin-bottom:0}.page .section ol ol{list-style-type:lower-roman}.page .section blockquote{margin:0 0 .8em;padding:0 15px;color:#858585;border-left:4px solid #e5e5e5}.page .section blockquote:first-child{margin-top:0}.page .section blockquote:last-child{margin-bottom:0}.page .section dl{padding:0}.page .section dl dt{padding:0;margin-top:.8em;font-style:italic}.page .section dl dd{padding:0 .8em;margin-bottom:.8em}.page .section dd{margin-left:0}a{color:#000;text-decoration:underline!important}.page-toc li{list-style-type:lower-alpha}.page-toc li .inner{border:none}


--------------------------------------------------------------------------------
/theme/assets/ebook/pdf.css:
--------------------------------------------------------------------------------
1 | .section.glossary>h1,.section.toc>h1{text-align:center}.page .section b,.page .section dl dt,.page .section strong,.page .section table th{font-weight:700}.link-inherit,.link-inherit:focus,.link-inherit:hover{color:inherit}.hidden{display:none}.section.toc>ol{margin:0;padding:0}.section.toc li{list-style:none}.section.toc li .inner{display:block;border-bottom:1px dotted #eee;margin-bottom:4px}.section.toc li .inner a,.section.toc li .inner span{padding-right:5px;border-bottom:1px solid #fff;margin-bottom:-1px}.section.toc li .inner .page{float:right;padding-left:5px}.section.toc li ol{margin:0;padding:0 0 0 2em}.dir-rtl .section.toc li .inner .page{float:left}.dir-rtl .section.toc li ol{margin:0;padding:0 2em 0 0}.section.glossary .glossary-entry{margin-bottom:40px}.section.glossary .glossary-entry h2 a,.section.glossary .glossary-entry h2 a:hover{color:inherit;text-decoration:none}.page .section,body{color:#000;text-size-adjust:100%;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}.section.glossary .glossary-entry .glossary-index{list-style:none;margin:0;padding:0}.section.glossary .glossary-entry .glossary-index li{display:inline;margin:0 8px;white-space:nowrap}body{font-family:sans-serif}.page .section{display:block;word-wrap:break-word;overflow:hidden;line-height:1.6;-moz-text-size-adjust:100%}.page .section *{box-sizing:border-box;-webkit-box-sizing:border-box;font-size:inherit}.page .section>:first-child{margin-top:0!important}.page .section>:last-child{margin-bottom:0!important}.page .section blockquote,.page .section code,.page .section figure,.page .section img,.page .section pre,.page .section table,.page .section tr{page-break-inside:avoid}.page .section h2,.page .section h3,.page .section h4,.page .section h5,.page .section p{orphans:3;widows:3}.page .section h1,.page .section h2,.page .section h3,.page .section h4,.page .section h5{page-break-after:avoid}.page .section em{font-style:italic}.page .section blockquote,.page .section dl,.page .section ol,.page .section p,.page .section table,.page .section ul{margin-top:0;margin-bottom:.8em}.page .section a{color:#4183c4;text-decoration:none;background:0 0}.page .section a:active,.page .section a:focus,.page .section a:hover{outline:0;text-decoration:underline}.page .section img{border:0;max-width:100%}.page .section hr{height:4px;padding:0;margin:1.6em 0;overflow:hidden;background-color:#e7e7e7;border:none}.page .section hr:after,.page .section hr:before{display:table;content:" "}.page .section hr:after{clear:both}.page .section h1,.page .section h2,.page .section h3,.page .section h4,.page .section h5,.page .section h6{margin-top:1.2em;margin-bottom:.8em;font-weight:700}.page .section h1{font-size:2em}.page .section h2{font-size:1.75em}.page .section h3{font-size:1.5em}.page .section h4{font-size:1.25em}.page .section h5{font-size:1em}.page .section h6{font-size:1em;color:#777}.page .section code,.page .section pre{font-family:Consolas,"Liberation Mono",Menlo,Courier,monospace;direction:ltr;border:none;color:inherit}.page .section pre{overflow:auto;word-wrap:normal;margin:0 0 1.2em;padding:.85em 1em;background:#f7f7f7}.page .section pre>code{display:inline;max-width:initial;padding:0;margin:0;overflow:initial;line-height:inherit;font-size:.85em;white-space:pre;background:0 0}.page .section pre>code:after,.page .section pre>code:before{content:normal}.page .section code{padding:.2em;margin:0;font-size:.85em;background-color:#f7f7f7}.page .section code:after,.page .section code:before{letter-spacing:-.2em;content:"\00a0"}.page .section table{display:table;width:100%;border-collapse:collapse;border-spacing:0;overflow:auto}.page .section table td,.page .section table th{padding:6px 13px;border:1px solid #ddd}.page .section table tr{background-color:#fff;border-top:1px solid #ccc}.page .section table tr:nth-child(2n){background-color:#f8f8f8}.page .section ol,.page .section ul{padding:0 0 0 2em;margin:0 0 .8em}.page .section ol ol,.page .section ol ul,.page .section ul ol,.page .section ul ul{margin-top:0;margin-bottom:0}.page .section ol ol{list-style-type:lower-roman}.page .section blockquote{margin:0 0 .8em;padding:0 15px;color:#858585;border-left:4px solid #e5e5e5}.page .section blockquote:first-child{margin-top:0}.page .section blockquote:last-child{margin-bottom:0}.page .section dl{padding:0}.page .section dl dt{padding:0;margin-top:.8em;font-style:italic}.pdf-footer,.pdf-header{margin-top:20px;color:#aaa}.page .section dl dd{padding:0 .8em;margin-bottom:.8em}.page .section dd{margin-left:0}.page .book-chapter{display:none}.pdf-footer{padding-top:10px;border-top:1px solid #eee}.pdf-footer .footer-pages-count{float:right}.pdf-header{padding-bottom:10px;border-bottom:1px solid #eee}


--------------------------------------------------------------------------------
/theme/assets/website/fonts/fontawesome/FontAwesome.otf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/lwdgit/gitbook/7ea236981098f287dab5fa84c1e471217e414af7/theme/assets/website/fonts/fontawesome/FontAwesome.otf


--------------------------------------------------------------------------------
/theme/assets/website/fonts/fontawesome/fontawesome-webfont.eot:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/lwdgit/gitbook/7ea236981098f287dab5fa84c1e471217e414af7/theme/assets/website/fonts/fontawesome/fontawesome-webfont.eot


--------------------------------------------------------------------------------
/theme/assets/website/fonts/fontawesome/fontawesome-webfont.ttf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/lwdgit/gitbook/7ea236981098f287dab5fa84c1e471217e414af7/theme/assets/website/fonts/fontawesome/fontawesome-webfont.ttf


--------------------------------------------------------------------------------
/theme/assets/website/fonts/fontawesome/fontawesome-webfont.woff:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/lwdgit/gitbook/7ea236981098f287dab5fa84c1e471217e414af7/theme/assets/website/fonts/fontawesome/fontawesome-webfont.woff


--------------------------------------------------------------------------------
/theme/assets/website/images/apple-touch-icon-precomposed-152.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/lwdgit/gitbook/7ea236981098f287dab5fa84c1e471217e414af7/theme/assets/website/images/apple-touch-icon-precomposed-152.png


--------------------------------------------------------------------------------
/theme/assets/website/images/favicon.ico:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/lwdgit/gitbook/7ea236981098f287dab5fa84c1e471217e414af7/theme/assets/website/images/favicon.ico


--------------------------------------------------------------------------------
/theme/i18n/ar.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "direction": "rtl",
 3 |     "LANGS_CHOOSE": "اختيار اللغة",
 4 |     "GLOSSARY": "قاموس مصطلحات",
 5 |     "GLOSSARY_INDEX": "مؤشر المصطلحات",
 6 |     "GLOSSARY_OPEN": "قاموس مصطلحات",
 7 |     "GITBOOK_LINK": "نشرت مع GitBook",
 8 |     "SUMMARY": "جدول المحتويات",
 9 |     "SUMMARY_INTRODUCTION": "مقدمة",
10 |     "SUMMARY_TOGGLE": "جدول المحتويات",
11 |     "SEARCH_TOGGLE": "بحث",
12 |     "SEARCH_PLACEHOLDER": "اكتب للبحث",
13 |     "FONTSETTINGS_TOGGLE": "إعدادات الخط",
14 |     "SHARE_TOGGLE": "حصة",
15 |     "SHARE_ON": "على {{platform}} حصة",
16 |     "FONTSETTINGS_WHITE": "أبيض",
17 |     "FONTSETTINGS_SEPIA": "بني داكن",
18 |     "FONTSETTINGS_NIGHT": "ليل",
19 |     "FONTSETTINGS_SANS": "بلا",
20 |     "FONTSETTINGS_SERIF": "الرقيق"
21 | }
22 | 


--------------------------------------------------------------------------------
/theme/i18n/bn.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "ভাষা নির্বাচন করুন",
 3 |     "GLOSSARY": "গ্লোসারি",
 4 |     "GLOSSARY_INDEX": "ইন্ডেক্স",
 5 |     "GLOSSARY_OPEN": "গ্লোসারি",
 6 |     "GITBOOK_LINK": "গিটবুকের মাধ্যমে প্রকাশিত",
 7 |     "SUMMARY": "সূচিপত্র",
 8 |     "SUMMARY_INTRODUCTION": "সূচনা",
 9 |     "SUMMARY_TOGGLE": "সূচিপত্র",
10 |     "SEARCH_TOGGLE": "অনুসন্ধান",
11 |     "SEARCH_PLACEHOLDER": "অনুসন্ধান",
12 |     "FONTSETTINGS_TOGGLE": "ফন্ট সেটিংস",
13 |     "SHARE_TOGGLE": "শেয়ার",
14 |     "SHARE_ON": "{{platform}}-এ শেয়ার",
15 |     "FONTSETTINGS_WHITE": "সাদা",
16 |     "FONTSETTINGS_SEPIA": "সেপিয়া",
17 |     "FONTSETTINGS_NIGHT": "রাত",
18 |     "FONTSETTINGS_SANS": "স্যান্স",
19 |     "FONTSETTINGS_SERIF": "শেরিফ"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/cs.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Zvolte jazyk",
 3 |     "GLOSSARY": "Slovníček",
 4 |     "GLOSSARY_INDEX": "Rejstřík",
 5 |     "GLOSSARY_OPEN": "Slovníček",
 6 |     "GITBOOK_LINK": "Publikováno pomocí GitBook",
 7 |     "SUMMARY": "Obsah",
 8 |     "SUMMARY_INTRODUCTION": "Úvod",
 9 |     "SUMMARY_TOGGLE": "Obsah",
10 |     "SEARCH_TOGGLE": "Hledání",
11 |     "SEARCH_PLACEHOLDER": "Vyhledat",
12 |     "FONTSETTINGS_TOGGLE": "Nastavení písma",
13 |     "SHARE_TOGGLE": "Sdílet",
14 |     "SHARE_ON": "Sdílet na {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Bílá",
16 |     "FONTSETTINGS_SEPIA": "Sépie",
17 |     "FONTSETTINGS_NIGHT": "Noc",
18 |     "FONTSETTINGS_SANS": "Bezpatkové",
19 |     "FONTSETTINGS_SERIF": "Patkové"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/de.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Sprache auswählen",
 3 |     "GLOSSARY": "Glossar",
 4 |     "GLOSSARY_INDEX": "Index",
 5 |     "GLOSSARY_OPEN": "Glossar",
 6 |     "GITBOOK_LINK": "Veröffentlicht mit GitBook",
 7 |     "SUMMARY": "Inhaltsverzeichnis",
 8 |     "SUMMARY_INTRODUCTION": "Einleitung",
 9 |     "SUMMARY_TOGGLE": "Inhaltsverzeichnis",
10 |     "SEARCH_TOGGLE": "Suche",
11 |     "SEARCH_PLACEHOLDER": "Suchbegriff eingeben",
12 |     "FONTSETTINGS_TOGGLE": "Schrifteinstellungen",
13 |     "SHARE_TOGGLE": "Teilen",
14 |     "SHARE_ON": "Auf {{platform}} teilen",
15 |     "FONTSETTINGS_WHITE": "Hell",
16 |     "FONTSETTINGS_SEPIA": "Sepia",
17 |     "FONTSETTINGS_NIGHT": "Nacht",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }


--------------------------------------------------------------------------------
/theme/i18n/en.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Choose a language",
 3 |     "GLOSSARY": "Glossary",
 4 |     "GLOSSARY_INDEX": "Index",
 5 |     "GLOSSARY_OPEN": "Glossary",
 6 |     "GITBOOK_LINK": "Published with GitBook",
 7 |     "SUMMARY": "Table of Contents",
 8 |     "SUMMARY_INTRODUCTION": "Introduction",
 9 |     "SUMMARY_TOGGLE": "Table of Contents",
10 |     "SEARCH_TOGGLE": "Search",
11 |     "SEARCH_PLACEHOLDER": "Type to search",
12 |     "FONTSETTINGS_TOGGLE": "Font Settings",
13 |     "SHARE_TOGGLE": "Share",
14 |     "SHARE_ON": "Share on {{platform}}",
15 |     "FONTSETTINGS_WHITE": "White",
16 |     "FONTSETTINGS_SEPIA": "Sepia",
17 |     "FONTSETTINGS_NIGHT": "Night",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/es.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Seleccione un idioma",
 3 |     "GLOSSARY": "Glosario",
 4 |     "GLOSSARY_INDEX": "Índice",
 5 |     "GLOSSARY_OPEN": "Glosario",
 6 |     "GITBOOK_LINK": "Publicado con GitBook",
 7 |     "SUMMARY": "Tabla de contenido",
 8 |     "SUMMARY_INTRODUCTION": "Introducción",
 9 |     "SUMMARY_TOGGLE": "Tabla de contenido",
10 |     "SEARCH_TOGGLE": "Busca",
11 |     "SEARCH_PLACEHOLDER": "Escribe para buscar",
12 |     "FONTSETTINGS_TOGGLE": "Configuración de fuente",
13 |     "SHARE_TOGGLE": "Comparte",
14 |     "SHARE_ON": "Comparte en {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Claro",
16 |     "FONTSETTINGS_SEPIA": "Sépia",
17 |     "FONTSETTINGS_NIGHT": "Noche",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/fa.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "direction": "rtl",
 3 |     "LANGS_CHOOSE": "انتخاب زبان",
 4 |     "GLOSSARY": "واژه‌نامه",
 5 |     "GLOSSARY_INDEX": "فهرست واژه‌ها",
 6 |     "GLOSSARY_OPEN": "واژه‌نامه",
 7 |     "GITBOOK_LINK": "انتشار یافته توسط GitBook",
 8 |     "SUMMARY": "فهرست مطالب",
 9 |     "SUMMARY_INTRODUCTION": "مقدمه",
10 |     "SUMMARY_TOGGLE": "فهرست مطالب",
11 |     "SEARCH_TOGGLE": "جستجو",
12 |     "SEARCH_PLACEHOLDER": "چیزی برای جستجو بنویسید",
13 |     "FONTSETTINGS_TOGGLE": "تنظیمات فونت",
14 |     "SHARE_TOGGLE": "اشتراک",
15 |     "SHARE_ON": "در {{platform}} به اشتراک بگذارید",
16 |     "FONTSETTINGS_WHITE": "سفید",
17 |     "FONTSETTINGS_SEPIA": "سپیا",
18 |     "FONTSETTINGS_NIGHT": "شب",
19 |     "FONTSETTINGS_SANS": "سنس",
20 |     "FONTSETTINGS_SERIF": "سریف"
21 | }
22 | 


--------------------------------------------------------------------------------
/theme/i18n/fi.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Valitse kieli",
 3 |     "GLOSSARY": "Sanasto",
 4 |     "GLOSSARY_INDEX": "Hakemisto",
 5 |     "GLOSSARY_OPEN": "Sanasto",
 6 |     "GITBOOK_LINK": "Julkaistu GitBookilla",
 7 |     "SUMMARY": "Sisällysluettelo",
 8 |     "SUMMARY_INTRODUCTION": "Johdanto",
 9 |     "SUMMARY_TOGGLE": "Sisällysluettelu",
10 |     "SEARCH_TOGGLE": "Etsi",
11 |     "SEARCH_PLACEHOLDER": "Kirjoita hakusana",
12 |     "FONTSETTINGS_TOGGLE": "Fonttivalinnat",
13 |     "SHARE_TOGGLE": "Jaa",
14 |     "SHARE_ON": "Jaa {{platform}}ssa",
15 |     "FONTSETTINGS_WHITE": "Valkoinen",
16 |     "FONTSETTINGS_SEPIA": "Seepia",
17 |     "FONTSETTINGS_NIGHT": "Yö",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/fr.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Choisissez une langue",
 3 |     "GLOSSARY": "Glossaire",
 4 |     "GLOSSARY_INDEX": "Index",
 5 |     "GLOSSARY_OPEN": "Glossaire",
 6 |     "GITBOOK_LINK": "Publié avec GitBook",
 7 |     "SUMMARY": "Table des matières",
 8 |     "SUMMARY_INTRODUCTION": "Introduction",
 9 |     "SUMMARY_TOGGLE": "Table des matières",
10 |     "SEARCH_TOGGLE": "Recherche",
11 |     "SEARCH_PLACEHOLDER": "Tapez pour rechercher",
12 |     "FONTSETTINGS_TOGGLE": "Paramètres de Police",
13 |     "SHARE_TOGGLE": "Partage",
14 |     "SHARE_ON": "Partager sur {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Clair",
16 |     "FONTSETTINGS_SEPIA": "Sépia",
17 |     "FONTSETTINGS_NIGHT": "Nuit",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }


--------------------------------------------------------------------------------
/theme/i18n/he.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "direction": "rtl",
 3 |     "LANGS_CHOOSE": "בחר שפה",
 4 |     "GLOSSARY": "מונחים",
 5 |     "GLOSSARY_INDEX": "מפתח",
 6 |     "GLOSSARY_OPEN": "מונחים",
 7 |     "GITBOOK_LINK": "הוצאה לאור באמצעות גיט-בוק GITBOOK",
 8 |     "SUMMARY": "תוכן העניינים",
 9 |     "SUMMARY_INTRODUCTION": "הוראות",
10 |     "SUMMARY_TOGGLE": "תקציר",
11 |     "SEARCH_TOGGLE": "חיפוש",
12 |     "SEARCH_PLACEHOLDER": "סוג החיפוש",
13 |     "FONTSETTINGS_TOGGLE": "הגדרת אותיות",
14 |     "SHARE_TOGGLE": "שתף",
15 |     "SHARE_ON": "{{platform}} שתף ב",
16 |     "FONTSETTINGS_WHITE": "בהיר",
17 |     "FONTSETTINGS_SEPIA": "חום כהה",
18 |     "FONTSETTINGS_NIGHT": "מצב לילה",
19 |     "FONTSETTINGS_SANS": "Sans",
20 |     "FONTSETTINGS_SERIF": "Serif"
21 | }
22 | 


--------------------------------------------------------------------------------
/theme/i18n/it.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Scegli una lingua",
 3 |     "GLOSSARY": "Glossario",
 4 |     "GLOSSARY_INDEX": "Indice",
 5 |     "GLOSSARY_OPEN": "Glossario",
 6 |     "GITBOOK_LINK": "Pubblicato con GitBook",
 7 |     "SUMMARY": "Sommario",
 8 |     "SUMMARY_INTRODUCTION": "Introduzione",
 9 |     "SUMMARY_TOGGLE": "Sommario",
10 |     "SEARCH_TOGGLE": "Cerca",
11 |     "SEARCH_PLACEHOLDER": "Scrivi per cercare",
12 |     "FONTSETTINGS_TOGGLE": "Impostazioni dei caratteri",
13 |     "SHARE_TOGGLE": "Condividi",
14 |     "SHARE_ON": "Condividi su {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Bianco",
16 |     "FONTSETTINGS_SEPIA": "Seppia",
17 |     "FONTSETTINGS_NIGHT": "Notte",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }


--------------------------------------------------------------------------------
/theme/i18n/ja.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "言語を選択",
 3 |     "GLOSSARY": "用語集",
 4 |     "GLOSSARY_INDEX": "索引",
 5 |     "GLOSSARY_OPEN": "用語集",
 6 |     "GITBOOK_LINK": "GitBookで公開 ",
 7 |     "SUMMARY": "目次",
 8 |     "SUMMARY_INTRODUCTION": "はじめに",
 9 |     "SUMMARY_TOGGLE": "目次",
10 |     "SEARCH_TOGGLE": "検索",
11 |     "SEARCH_PLACEHOLDER": "検索すると入力",
12 |     "FONTSETTINGS_TOGGLE": "フォント設定",
13 |     "SHARE_TOGGLE": "シェア",
14 |     "SHARE_ON": "{{platform}}でシェア",
15 |     "FONTSETTINGS_WHITE": "白",
16 |     "FONTSETTINGS_SEPIA": "セピア",
17 |     "FONTSETTINGS_NIGHT": "夜",
18 |     "FONTSETTINGS_SANS": "ゴシック体",
19 |     "FONTSETTINGS_SERIF": "明朝体"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/ko.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "언어를 선택하세요",
 3 |     "GLOSSARY": "어휘",
 4 |     "GLOSSARY_INDEX": "색인",
 5 |     "GLOSSARY_OPEN": "어휘",
 6 |     "GITBOOK_LINK": "GitBook에 게시",
 7 |     "SUMMARY": "차례",
 8 |     "SUMMARY_INTRODUCTION": "소개",
 9 |     "SUMMARY_TOGGLE": "차례",
10 |     "SEARCH_TOGGLE": "검색",
11 |     "SEARCH_PLACEHOLDER": "검색어 입력",
12 |     "FONTSETTINGS_TOGGLE": "글꼴 설정",
13 |     "SHARE_TOGGLE": "공유",
14 |     "SHARE_ON": "{{platform}}에 공유",
15 |     "FONTSETTINGS_WHITE": "화이트",
16 |     "FONTSETTINGS_SEPIA": "세피아",
17 |     "FONTSETTINGS_NIGHT": "나이트",
18 |     "FONTSETTINGS_SANS": "고딕",
19 |     "FONTSETTINGS_SERIF": "명조"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/no.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Velg språk",
 3 |     "GLOSSARY": "Register",
 4 |     "GLOSSARY_INDEX": "Indeks",
 5 |     "GLOSSARY_OPEN": "Register",
 6 |     "GITBOOK_LINK": "Publisert med GitBook",
 7 |     "SUMMARY": "Innholdsfortegnelse",
 8 |     "SUMMARY_INTRODUCTION": "Innledning",
 9 |     "SUMMARY_TOGGLE": "Innholdsfortegnelse",
10 |     "SEARCH_TOGGLE": "Søk",
11 |     "SEARCH_PLACEHOLDER": "Skriv inn søkeord",
12 |     "FONTSETTINGS_TOGGLE": "Tekstinnstillinger",
13 |     "SHARE_TOGGLE": "Del",
14 |     "SHARE_ON": "Del på {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Lys",
16 |     "FONTSETTINGS_SEPIA": "Sepia",
17 |     "FONTSETTINGS_NIGHT": "Mørk",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/pl.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Wybierz język",
 3 |     "GLOSSARY": "Glosariusz",
 4 |     "GLOSSARY_INDEX": "Indeks",
 5 |     "GLOSSARY_OPEN": "Glosariusz",
 6 |     "GITBOOK_LINK": "Opublikowano dzięki GitBook",
 7 |     "SUMMARY": "Spis treści",
 8 |     "SUMMARY_INTRODUCTION": "Wstęp",
 9 |     "SUMMARY_TOGGLE": "Spis treści",
10 |     "SEARCH_TOGGLE": "Szukaj",
11 |     "SEARCH_PLACEHOLDER": "Wpisz szukaną frazę",
12 |     "FONTSETTINGS_TOGGLE": "Ustawienia czcionki",
13 |     "SHARE_TOGGLE": "Udostępnij",
14 |     "SHARE_ON": "Udostępnij na {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Jasny",
16 |     "FONTSETTINGS_SEPIA": "Sepia",
17 |     "FONTSETTINGS_NIGHT": "Noc",
18 |     "FONTSETTINGS_SANS": "Bezszeryfowa",
19 |     "FONTSETTINGS_SERIF": "Szeryfowa"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/pt.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Escolher sua língua",
 3 |     "GLOSSARY": "Glossário",
 4 |     "GLOSSARY_INDEX": "Índice",
 5 |     "GLOSSARY_OPEN": "Glossário",
 6 |     "GITBOOK_LINK": "Publicado com GitBook",
 7 |     "SUMMARY": "Tabela de conteúdos",
 8 |     "SUMMARY_INTRODUCTION": "Introdução",
 9 |     "SUMMARY_TOGGLE": "Tabela de conteúdos",
10 |     "SEARCH_TOGGLE": "Pesquise",
11 |     "SEARCH_PLACEHOLDER": "Escreva para pesquisar",
12 |     "FONTSETTINGS_TOGGLE": "Configurações de fonte",
13 |     "SHARE_TOGGLE": "Compartilhar",
14 |     "SHARE_ON": "Compartilhar no {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Claro",
16 |     "FONTSETTINGS_SEPIA": "Sépia",
17 |     "FONTSETTINGS_NIGHT": "Noite",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/ro.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Alege o limba",
 3 |     "GLOSSARY": "Glosar",
 4 |     "GLOSSARY_INDEX": "Index",
 5 |     "GLOSSARY_OPEN": "Glosar",
 6 |     "GITBOOK_LINK": "Publicata cu GitBook",
 7 |     "SUMMARY": "Cuprins",
 8 |     "SUMMARY_INTRODUCTION": "Introducere",
 9 |     "SUMMARY_TOGGLE": "Cuprins",
10 |     "SEARCH_TOGGLE": "Cauta",
11 |     "SEARCH_PLACEHOLDER": "Ce cauti",
12 |     "FONTSETTINGS_TOGGLE": "Setari de font",
13 |     "SHARE_TOGGLE": "Distribuie",
14 |     "SHARE_ON": "Distribuie pe {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Alb",
16 |     "FONTSETTINGS_SEPIA": "Sepia",
17 |     "FONTSETTINGS_NIGHT": "Noapte",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/ru.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Выберите язык",
 3 |     "GLOSSARY": "Алфавитный указатель",
 4 |     "GLOSSARY_INDEX": "Алфавитный указатель",
 5 |     "GLOSSARY_OPEN": "Алфавитный указатель",
 6 |     "GITBOOK_LINK": "Опубликовано с помощью GitBook",
 7 |     "SUMMARY": "Содержание",
 8 |     "SUMMARY_INTRODUCTION": "Введение",
 9 |     "SUMMARY_TOGGLE": "Содержание",
10 |     "SEARCH_TOGGLE": "Поиск",
11 |     "SEARCH_PLACEHOLDER": "Введите условия поиска",
12 |     "FONTSETTINGS_TOGGLE": "Шрифт",
13 |     "SHARE_TOGGLE": "Поделиться",
14 |     "SHARE_ON": "Поделиться в {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Светлый",
16 |     "FONTSETTINGS_SEPIA": "Сепия",
17 |     "FONTSETTINGS_NIGHT": "Тёмный",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }


--------------------------------------------------------------------------------
/theme/i18n/sv.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Välj språk",
 3 |     "GLOSSARY": "Gloslista",
 4 |     "GLOSSARY_INDEX": "Index",
 5 |     "GLOSSARY_OPEN": "Gloslista",
 6 |     "GITBOOK_LINK": "Publicera med GitBook",
 7 |     "SUMMARY": "Innehållsförteckning",
 8 |     "SUMMARY_INTRODUCTION": "Inledning",
 9 |     "SUMMARY_TOGGLE": "Innehållsförteckning",
10 |     "SEARCH_TOGGLE": "Sök",
11 |     "SEARCH_PLACEHOLDER": "Skriv sökord",
12 |     "FONTSETTINGS_TOGGLE": "Textinställningar",
13 |     "SHARE_TOGGLE": "Dela",
14 |     "SHARE_ON": "Dela på {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Ljus",
16 |     "FONTSETTINGS_SEPIA": "Sepia",
17 |     "FONTSETTINGS_NIGHT": "Mörk",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/uk.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Виберіть мову",
 3 |     "GLOSSARY": "Глосарій",
 4 |     "GLOSSARY_INDEX": "Глосарій",
 5 |     "GLOSSARY_OPEN": "Глосарій",
 6 |     "GITBOOK_LINK": "Опубліковано за допомогою GitBook",
 7 |     "SUMMARY": "Зміст",
 8 |     "SUMMARY_INTRODUCTION": "Вступ",
 9 |     "SUMMARY_TOGGLE": "Зміст",
10 |     "SEARCH_TOGGLE": "Пошук",
11 |     "SEARCH_PLACEHOLDER": "Введіть для пошуку",
12 |     "FONTSETTINGS_TOGGLE": "Шрифт",
13 |     "SHARE_TOGGLE": "Поділиться",
14 |     "SHARE_ON": "Поділитися в {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Світлий",
16 |     "FONTSETTINGS_SEPIA": "Сепія",
17 |     "FONTSETTINGS_NIGHT": "Темний",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }


--------------------------------------------------------------------------------
/theme/i18n/vi.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "Lựa chọn ngôn ngữ",
 3 |     "GLOSSARY": "Chú giải",
 4 |     "GLOSSARY_INDEX": "Chỉ mục",
 5 |     "GLOSSARY_OPEN": "Chú giải",
 6 |     "GITBOOK_LINK": "Xuất bản với GitBook",
 7 |     "SUMMARY": "Mục Lục",
 8 |     "SUMMARY_INTRODUCTION": "Giới thiệu",
 9 |     "SUMMARY_TOGGLE": "Mục Lục",
10 |     "SEARCH_TOGGLE": "Tìm kiếm",
11 |     "SEARCH_PLACEHOLDER": "Nhập thông tin cần tìm",
12 |     "FONTSETTINGS_TOGGLE": "Tùy chỉnh phông chữ",
13 |     "SHARE_TOGGLE": "Chia sẻ",
14 |     "SHARE_ON": "Chia sẻ trên {{platform}}",
15 |     "FONTSETTINGS_WHITE": "Sáng",
16 |     "FONTSETTINGS_SEPIA": "Vàng nâu",
17 |     "FONTSETTINGS_NIGHT": "Tối",
18 |     "FONTSETTINGS_SANS": "Sans",
19 |     "FONTSETTINGS_SERIF": "Serif"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/zh-hans.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "选择一种语言",
 3 |     "GLOSSARY": "术语表",
 4 |     "GLOSSARY_INDEX": "索引",
 5 |     "GLOSSARY_OPEN": "术语表",
 6 |     "GITBOOK_LINK": "本书使用 GitBook 发布",
 7 |     "SUMMARY": "目录",
 8 |     "SUMMARY_INTRODUCTION": "介绍",
 9 |     "SUMMARY_TOGGLE": "目录",
10 |     "SEARCH_TOGGLE": "搜索",
11 |     "SEARCH_PLACEHOLDER": "输入并搜索",
12 |     "FONTSETTINGS_TOGGLE": "字体设置",
13 |     "SHARE_TOGGLE": "分享",
14 |     "SHARE_ON": "分享到 {{platform}}",
15 |     "FONTSETTINGS_WHITE": "白色",
16 |     "FONTSETTINGS_SEPIA": "棕褐色",
17 |     "FONTSETTINGS_NIGHT": "夜间",
18 |     "FONTSETTINGS_SANS": "无衬线体",
19 |     "FONTSETTINGS_SERIF": "衬线体"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/i18n/zh-tw.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "LANGS_CHOOSE": "選擇一種語言",
 3 |     "GLOSSARY": "術語表",
 4 |     "GLOSSARY_INDEX": "索引",
 5 |     "GLOSSARY_OPEN": "術語表",
 6 |     "GITBOOK_LINK": "本書使用 GitBook 釋出",
 7 |     "SUMMARY": "目錄",
 8 |     "SUMMARY_INTRODUCTION": "介紹",
 9 |     "SUMMARY_TOGGLE": "目錄",
10 |     "SEARCH_TOGGLE": "搜尋",
11 |     "SEARCH_PLACEHOLDER": "輸入並搜尋",
12 |     "FONTSETTINGS_TOGGLE": "字型設定",
13 |     "SHARE_TOGGLE": "分享",
14 |     "SHARE_ON": "分享到 {{platform}}",
15 |     "FONTSETTINGS_WHITE": "白色",
16 |     "FONTSETTINGS_SEPIA": "棕褐色",
17 |     "FONTSETTINGS_NIGHT": "夜間",
18 |     "FONTSETTINGS_SANS": "無襯線體",
19 |     "FONTSETTINGS_SERIF": "襯線體"
20 | }
21 | 


--------------------------------------------------------------------------------
/theme/javascript/dropdown.js:
--------------------------------------------------------------------------------
 1 | var $ = require('jquery');
 2 | 
 3 | function toggleDropdown(e) {
 4 |     var $dropdown = $(e.currentTarget).parent().find('.dropdown-menu');
 5 | 
 6 |     $dropdown.toggleClass('open');
 7 |     e.stopPropagation();
 8 |     e.preventDefault();
 9 | }
10 | 
11 | function closeDropdown(e) {
12 |     $('.dropdown-menu').removeClass('open');
13 | }
14 | 
15 | // Bind all dropdown
16 | function init() {
17 |     $(document).on('click', '.toggle-dropdown', toggleDropdown);
18 |     $(document).on('click', '.dropdown-menu', function(e){ e.stopPropagation(); });
19 |     $(document).on('click', closeDropdown);
20 | }
21 | 
22 | module.exports = {
23 |     init: init
24 | };
25 | 
26 | 


--------------------------------------------------------------------------------
/theme/javascript/events.js:
--------------------------------------------------------------------------------
1 | var $ = require('jquery');
2 | 
3 | module.exports = $({});
4 | 
5 | 


--------------------------------------------------------------------------------
/theme/javascript/index.js:
--------------------------------------------------------------------------------
 1 | var $ = require('jquery');
 2 | var _ = require('lodash');
 3 | 
 4 | var storage = require('./storage');
 5 | var dropdown = require('./dropdown');
 6 | var events = require('./events');
 7 | var state = require('./state');
 8 | var keyboard = require('./keyboard');
 9 | var navigation = require('./navigation');
10 | var sidebar = require('./sidebar');
11 | var toolbar = require('./toolbar');
12 | 
13 | 
14 | function start(config) {
15 |     // Init sidebar
16 |     sidebar.init();
17 | 
18 |     // Init keyboard
19 |     keyboard.init();
20 | 
21 |     // Bind dropdown
22 |     dropdown.init();
23 | 
24 |     // Init navigation
25 |     navigation.init();
26 | 
27 | 
28 |     // Add action to toggle sidebar
29 |     toolbar.createButton({
30 |         index: 0,
31 |         icon: 'fa fa-align-justify',
32 |         onClick: function(e) {
33 |             e.preventDefault();
34 |             sidebar.toggle();
35 |         }
36 |     });
37 | 
38 |     events.trigger('start', config);
39 |     navigation.notify();
40 | }
41 | 
42 | // Export APIs for plugins
43 | var gitbook = {
44 |     start: start,
45 |     events: events,
46 |     state: state,
47 | 
48 |     // UI sections
49 |     toolbar: toolbar,
50 |     sidebar: sidebar,
51 | 
52 |     // Read/Write the localstorage
53 |     storage: storage,
54 | 
55 |     // Create keyboard shortcuts
56 |     keyboard: keyboard
57 | };
58 | 
59 | 
60 | // Modules mapping for plugins
61 | var MODULES = {
62 |     'gitbook': gitbook,
63 |     'jquery': $,
64 |     'lodash': _
65 | };
66 | 
67 | window.gitbook = gitbook;
68 | window.$ = $;
69 | window.jQuery = $;
70 | window.require = function(mods, fn) {
71 |     mods = _.map(mods, function(mod) {
72 |         mod = mod.toLowerCase();
73 |         if (!MODULES[mod]) {
74 |             throw new Error('GitBook module '+mod+' doesn\'t exist');
75 |         }
76 | 
77 |         return MODULES[mod];
78 |     });
79 | 
80 |     fn.apply(null, mods);
81 | };
82 | 
83 | module.exports = {};
84 | 
85 | 


--------------------------------------------------------------------------------
/theme/javascript/keyboard.js:
--------------------------------------------------------------------------------
 1 | var Mousetrap = require('mousetrap');
 2 | 
 3 | var navigation = require('./navigation');
 4 | var sidebar = require('./sidebar');
 5 | 
 6 | // Bind a keyboard shortcuts
 7 | function bindShortcut(keys, fn) {
 8 |     Mousetrap.bind(keys, function(e) {
 9 |         fn();
10 |         return false;
11 |     });
12 | }
13 | 
14 | 
15 | // Bind keyboard shortcuts
16 | function init() {
17 |     // Next
18 |     bindShortcut(['right'], function(e) {
19 |         navigation.goNext();
20 |     });
21 | 
22 |     // Prev
23 |     bindShortcut(['left'], function(e) {
24 |         navigation.goPrev();
25 |     });
26 | 
27 |     // Toggle Summary
28 |     bindShortcut(['s'], function(e) {
29 |         sidebar.toggle();
30 |     });
31 | }
32 | 
33 | module.exports = {
34 |     init: init,
35 |     bind: bindShortcut
36 | };
37 | 


--------------------------------------------------------------------------------
/theme/javascript/loading.js:
--------------------------------------------------------------------------------
 1 | var state = require('./state');
 2 | 
 3 | function showLoading(p) {
 4 |     state.$book.addClass('is-loading');
 5 |     p.always(function() {
 6 |         state.$book.removeClass('is-loading');
 7 |     });
 8 | 
 9 |     return p;
10 | }
11 | 
12 | module.exports = {
13 |     show: showLoading
14 | };
15 | 


--------------------------------------------------------------------------------
/theme/javascript/navigation.js:
--------------------------------------------------------------------------------
  1 | var $ = require('jquery');
  2 | var url = require('url');
  3 | 
  4 | var events = require('./events');
  5 | var state = require('./state');
  6 | var loading = require('./loading');
  7 | 
  8 | 
  9 | var usePushState = (typeof history.pushState !== 'undefined');
 10 | 
 11 | function handleNavigation(relativeUrl, push) {
 12 |     var uri = url.resolve(window.location.pathname, relativeUrl);
 13 | 
 14 |     if (!usePushState) {
 15 |         // Refresh the page to the new URL if pushState not supported
 16 |         location.href = relativeUrl;
 17 |         return;
 18 |     }
 19 | 
 20 |     return loading.show($.get(uri)
 21 |     .done(function (html) {
 22 |         // Push url to history
 23 |         if (push) history.pushState({ path: uri }, null, uri);
 24 | 
 25 |         // Replace html content
 26 |         html = html.replace( /<(\/?)(html|head|body)([^>]*)>/ig, function(a,b,c,d){
 27 |             return '<' + b + 'div' + ( b ? '' : ' data-element="' + c + '"' ) + d + '>';
 28 |         });
 29 | 
 30 |         var $page = $(html);
 31 |         var $pageHead = $page.find('[data-element=head]');
 32 |         var $pageBody = $page.find('.book');
 33 | 
 34 |         // Merge heads
 35 |         // !! Warning !!: we only update necessary portions to avoid strange behavior (page flickering etc ...)
 36 | 
 37 |         // Update title
 38 |         document.title = $pageHead.find('title').text();
 39 | 
 40 |         // Reference to $('head');
 41 |         var $head = $('head');
 42 | 
 43 |         // Update next & prev <link> tags
 44 |         // Remove old
 45 |         $head.find('link[rel=prev]').remove();
 46 |         $head.find('link[rel=next]').remove();
 47 | 
 48 |         // Add new next * prev <link> tags
 49 |         $head.append($pageHead.find('link[rel=prev]'));
 50 |         $head.append($pageHead.find('link[rel=next]'));
 51 | 
 52 |         // Merge body
 53 |         var bodyClass = $('.book').attr('class');
 54 |         var scrollPosition = $('.book-summary .summary').scrollTop();
 55 |         $pageBody.toggleClass('with-summary', $('.book').hasClass('with-summary'));
 56 | 
 57 |         $('.book').replaceWith($pageBody);
 58 |         $('.book').attr('class', bodyClass);
 59 |         $('.book-summary .summary').scrollTop(scrollPosition);
 60 | 
 61 |         // Update state
 62 |         state.update($('html'));
 63 |         preparePage();
 64 |     })
 65 |     .fail(function (e) {
 66 |         location.href = relativeUrl;
 67 |     }));
 68 | }
 69 | 
 70 | function updateNavigationPosition() {
 71 |     var bodyInnerWidth, pageWrapperWidth;
 72 | 
 73 |     bodyInnerWidth = parseInt($('.body-inner').css('width'), 10);
 74 |     pageWrapperWidth = parseInt($('.page-wrapper').css('width'), 10);
 75 |     $('.navigation-next').css('margin-right', (bodyInnerWidth - pageWrapperWidth) + 'px');
 76 | }
 77 | 
 78 | function notifyPageChange() {
 79 |     events.trigger('page.change');
 80 | }
 81 | 
 82 | function preparePage(notify) {
 83 |     var $bookBody = $('.book-body');
 84 |     var $bookInner = $bookBody.find('.body-inner');
 85 |     var $pageWrapper = $bookInner.find('.page-wrapper');
 86 | 
 87 |     // Update navigation position
 88 |     updateNavigationPosition();
 89 | 
 90 |     // Focus on content
 91 |     $pageWrapper.focus();
 92 | 
 93 |     // Reset scroll
 94 |     $bookInner.scrollTop(0);
 95 |     $bookBody.scrollTop(0);
 96 | 
 97 |     // Notify
 98 |     if (notify !== false) notifyPageChange();
 99 | }
100 | 
101 | function isLeftClickEvent(e) {
102 |     return e.button === 0;
103 | }
104 | 
105 | function isModifiedEvent(e) {
106 |     return !!(e.metaKey || e.altKey || e.ctrlKey || e.shiftKey);
107 | }
108 | 
109 | function handlePagination(e) {
110 |     if (isModifiedEvent(e) || !isLeftClickEvent(e)) {
111 |         return;
112 |     }
113 | 
114 |     e.stopPropagation();
115 |     e.preventDefault();
116 | 
117 |     var url = $(this).attr('href');
118 |     if (url) handleNavigation(url, true);
119 | }
120 | 
121 | function goNext() {
122 |     var url = $('.navigation-next').attr('href');
123 |     if (url) handleNavigation(url, true);
124 | }
125 | 
126 | function goPrev() {
127 |     var url = $('.navigation-prev').attr('href');
128 |     if (url) handleNavigation(url, true);
129 | }
130 | 
131 | 
132 | function init() {
133 |     // Prevent cache so that using the back button works
134 |     // See: http://stackoverflow.com/a/15805399/983070
135 |     $.ajaxSetup({
136 |         cache: false
137 |     });
138 | 
139 |     // Recreate first page when the page loads.
140 |     history.replaceState({ path: window.location.href }, '');
141 | 
142 |     // Back Button Hijacking :(
143 |     window.onpopstate = function (event) {
144 |         if (event.state === null) {
145 |             return;
146 |         }
147 |         return handleNavigation(event.state.path, false);
148 |     };
149 | 
150 |     $(document).on('click', '.navigation-prev', handlePagination);
151 |     $(document).on('click', '.navigation-next', handlePagination);
152 |     $(document).on('click', '.summary [data-path] a', handlePagination);
153 | 
154 |     $(window).resize(updateNavigationPosition);
155 | 
156 |     // Prepare current page
157 |     preparePage(false);
158 | }
159 | 
160 | module.exports = {
161 |     init: init,
162 |     goNext: goNext,
163 |     goPrev: goPrev,
164 |     notify: notifyPageChange
165 | };
166 | 


--------------------------------------------------------------------------------
/theme/javascript/platform.js:
--------------------------------------------------------------------------------
1 | module.exports = {
2 |     isMobile: function() {
3 |         return (document.width <= 600);
4 |     }
5 | };
6 | 


--------------------------------------------------------------------------------
/theme/javascript/sidebar.js:
--------------------------------------------------------------------------------
 1 | var $ = require('jquery');
 2 | var _ = require('lodash');
 3 | 
 4 | var storage = require('./storage');
 5 | var platform = require('./platform');
 6 | var state = require('./state');
 7 | 
 8 | 
 9 | // Toggle sidebar with or withour animation
10 | function toggleSidebar(_state, animation) {
11 |     if (state != null && isOpen() == _state) return;
12 |     if (animation == null) animation = true;
13 | 
14 |     state.$book.toggleClass('without-animation', !animation);
15 |     state.$book.toggleClass('with-summary', _state);
16 | 
17 |     storage.set('sidebar', isOpen());
18 | }
19 | 
20 | // Return true if sidebar is open
21 | function isOpen() {
22 |     return state.$book.hasClass('with-summary');
23 | }
24 | 
25 | // Prepare sidebar: state and toggle button
26 | function init() {
27 |     // Init last state if not mobile
28 |     if (!platform.isMobile()) {
29 |         toggleSidebar(storage.get('sidebar', true), false);
30 |     }
31 | 
32 |     // Close sidebar after clicking a link on mobile
33 |     $(document).on('click', '.book-summary li.chapter a', function(e) {
34 |         if (platform.isMobile()) toggleSidebar(false, false);
35 |     });
36 | }
37 | 
38 | // Filter summary with a list of path
39 | function filterSummary(paths) {
40 |     var $summary = $('.book-summary');
41 | 
42 |     $summary.find('li').each(function() {
43 |         var path = $(this).data('path');
44 |         var st = paths == null || _.contains(paths, path);
45 | 
46 |         $(this).toggle(st);
47 |         if (st) $(this).parents('li').show();
48 |     });
49 | }
50 | 
51 | module.exports = {
52 |     init: init,
53 |     isOpen: isOpen,
54 |     toggle: toggleSidebar,
55 |     filter: filterSummary
56 | };
57 | 


--------------------------------------------------------------------------------
/theme/javascript/state.js:
--------------------------------------------------------------------------------
 1 | var $ = require('jquery');
 2 | var url = require('url');
 3 | var path = require('path');
 4 | 
 5 | var state = {};
 6 | 
 7 | state.update = function(dom) {
 8 |     var $book = $(dom.find('.book'));
 9 | 
10 |     state.$book = $book;
11 |     state.level = $book.data('level');
12 |     state.basePath = $book.data('basepath');
13 | 
14 |     // If book is multilingual, language of this book
15 |     state.innerLanguage = $book.data('innerlanguage');
16 | 
17 |     // Date of build
18 |     state.revision = $book.data('revision');
19 | 
20 |     // Original path of the file
21 |     state.filepath = $book.data('filepath');
22 | 
23 |     // Title of the chapter
24 |     state.chapterTitle = $book.data('chapter-title');
25 | 
26 |     // Absolute url to the root of the book (inner book)
27 |     state.root = url.resolve(
28 |         location.protocol+'//'+location.host,
29 |         path.dirname(path.resolve(location.pathname.replace(/\/$/, '/index.html'), state.basePath))
30 |     ).replace(/\/?$/, '/');
31 | 
32 |     // Absolute root to the language (for multilingual book)
33 |     state.bookRoot = state.innerLanguage? url.resolve(state.root, '..') : state.root;
34 | };
35 | 
36 | state.update($);
37 | 
38 | module.exports = state;
39 | 


--------------------------------------------------------------------------------
/theme/javascript/storage.js:
--------------------------------------------------------------------------------
 1 | var baseKey = '';
 2 | 
 3 | /*
 4 |  * Simple module for storing data in the browser's local storage
 5 |  */
 6 | module.exports = {
 7 |     setBaseKey: function(key) {
 8 |         baseKey = key;
 9 |     },
10 | 
11 |     // Write something in localstorage
12 |     set: function(key, value) {
13 |         key = baseKey+':'+key;
14 | 
15 |         try {
16 |             localStorage[key] = JSON.stringify(value);
17 |         } catch(e) {}
18 |     },
19 | 
20 |     // Read a value from localstorage
21 |     get: function(key, def) {
22 |         key = baseKey+':'+key;
23 |         if (localStorage[key] === undefined) return def;
24 |         try {
25 |             var v = JSON.parse(localStorage[key]);
26 |             return v == null ? def : v;;
27 |         } catch(err) {
28 |             return localStorage[key] || def;
29 |         }
30 |     },
31 | 
32 |     // Remove a key from localstorage
33 |     remove: function(key) {
34 |         key = baseKey+':'+key;
35 |         localStorage.removeItem(key);
36 |     }
37 | };
38 | 


--------------------------------------------------------------------------------
/theme/javascript/toolbar.js:
--------------------------------------------------------------------------------
  1 | var $ = require('jquery');
  2 | var _ = require('lodash');
  3 | 
  4 | var events = require('./events');
  5 | 
  6 | // List of created buttons
  7 | var buttons = [];
  8 | 
  9 | // Insert a jquery element at a specific position
 10 | function insertAt(parent, selector, index, element) {
 11 |     var lastIndex = parent.children(selector).size();
 12 |     if (index < 0) {
 13 |         index = Math.max(0, lastIndex + 1 + index);
 14 |     }
 15 |     parent.append(element);
 16 | 
 17 |     if (index < lastIndex) {
 18 |         parent.children(selector).eq(index).before(parent.children(selector).last());
 19 |     }
 20 | }
 21 | 
 22 | // Default click handler
 23 | function defaultOnClick(e) {
 24 |     e.preventDefault();
 25 | }
 26 | 
 27 | // Create a dropdown menu
 28 | function createDropdownMenu(dropdown) {
 29 |     var $menu = $('<div>', {
 30 |         'class': 'dropdown-menu',
 31 |         'html': '<div class="dropdown-caret"><span class="caret-outer"></span><span class="caret-inner"></span></div>'
 32 |     });
 33 | 
 34 |     if (_.isString(dropdown)) {
 35 |         $menu.append(dropdown);
 36 |     } else {
 37 |         var groups = _.map(dropdown, function(group) {
 38 |             if (_.isArray(group)) return group;
 39 |             else return [group];
 40 |         });
 41 | 
 42 |         // Create buttons groups
 43 |         _.each(groups, function(group) {
 44 |             var $group = $('<div>', {
 45 |                 'class': 'buttons'
 46 |             });
 47 |             var sizeClass = 'size-'+group.length;
 48 | 
 49 |             // Append buttons
 50 |             _.each(group, function(btn) {
 51 |                 btn = _.defaults(btn || {}, {
 52 |                     text: '',
 53 |                     className: '',
 54 |                     onClick: defaultOnClick
 55 |                 });
 56 | 
 57 |                 var $btn = $('<button>', {
 58 |                     'class': 'button '+sizeClass+' '+btn.className,
 59 |                     'text': btn.text
 60 |                 });
 61 |                 $btn.click(btn.onClick);
 62 | 
 63 |                 $group.append($btn);
 64 |             });
 65 | 
 66 | 
 67 |             $menu.append($group);
 68 |         });
 69 | 
 70 |     }
 71 | 
 72 | 
 73 |     return $menu;
 74 | }
 75 | 
 76 | // Create a new button in the toolbar
 77 | function createButton(opts) {
 78 |     opts = _.defaults(opts || {}, {
 79 |         // Aria label for the button
 80 |         label: '',
 81 | 
 82 |         // Icon to show
 83 |         icon: '',
 84 | 
 85 |         // Inner text
 86 |         text: '',
 87 | 
 88 |         // Right or left position
 89 |         position: 'left',
 90 | 
 91 |         // Other class name to add to the button
 92 |         className: '',
 93 | 
 94 |         // Triggered when user click on the button
 95 |         onClick: defaultOnClick,
 96 | 
 97 |         // Button is a dropdown
 98 |         dropdown: null,
 99 | 
100 |         // Position in the toolbar
101 |         index: null
102 |     });
103 | 
104 |     buttons.push(opts);
105 |     updateButton(opts);
106 | }
107 | 
108 | // Update a button
109 | function updateButton(opts) {
110 |     var $result;
111 |     var $toolbar = $('.book-header');
112 |     var $title = $toolbar.find('h1');
113 | 
114 |     // Build class name
115 |     var positionClass = 'pull-'+opts.position;
116 | 
117 |     // Create button
118 |     var $btn = $('<a>', {
119 |         'class': 'btn',
120 |         'text': opts.text? ' ' + opts.text : '',
121 |         'aria-label': opts.label,
122 |         'href': '#'
123 |     });
124 | 
125 |     // Bind click
126 |     $btn.click(opts.onClick);
127 | 
128 |     // Prepend icon
129 |     if (opts.icon) {
130 |         $('<i>', {
131 |             'class': opts.icon
132 |         }).prependTo($btn);
133 |     }
134 | 
135 |     // Prepare dropdown
136 |     if (opts.dropdown) {
137 |         var $container = $('<div>', {
138 |             'class': 'dropdown '+positionClass+' '+opts.className
139 |         });
140 | 
141 |         // Add button to container
142 |         $btn.addClass('toggle-dropdown');
143 |         $container.append($btn);
144 | 
145 |         // Create inner menu
146 |         var $menu = createDropdownMenu(opts.dropdown);
147 | 
148 |         // Menu position
149 |         $menu.addClass('dropdown-'+(opts.position == 'right'? 'left' : 'right'));
150 | 
151 |         $container.append($menu);
152 |         $result = $container;
153 |     } else {
154 |         $btn.addClass(positionClass);
155 |         $btn.addClass(opts.className);
156 |         $result = $btn;
157 |     }
158 | 
159 |     $result.addClass('js-toolbar-action');
160 | 
161 |     if (_.isNumber(opts.index) && opts.index >= 0) {
162 |         insertAt($toolbar, '.btn, .dropdown, h1', opts.index, $result);
163 |     } else {
164 |         $result.insertBefore($title);
165 |     }
166 | }
167 | 
168 | // Update all buttons
169 | function updateAllButtons() {
170 |     $('.js-toolbar-action').remove();
171 |     _.each(buttons, updateButton);
172 | }
173 | 
174 | // When page changed, reset buttons
175 | events.bind('page.change', function() {
176 |     updateAllButtons();
177 | });
178 | 
179 | module.exports = {
180 |     createButton: createButton
181 | };
182 | 


--------------------------------------------------------------------------------
/theme/stylesheets/base/mixins.less:
--------------------------------------------------------------------------------
 1 | @import "../../../node_modules/gitbook-markdown-css/less/mixin.less";
 2 | 
 3 | .link-inherit {
 4 |     color: inherit;
 5 | 
 6 |     &:hover, &:focus {
 7 |         color: inherit;
 8 |     }
 9 | }
10 | 
11 | .transition-transform(@transition) {
12 |   -webkit-transition: -webkit-transform @transition;
13 |      -moz-transition: -moz-transform @transition;
14 |        -o-transition: -o-transform @transition;
15 |           transition: transform @transition;
16 | }
17 | 
18 | .hidden {
19 |     display: none;
20 | }
21 | 
22 | .box-sizing(@value) {
23 |     -moz-box-sizing: @value;
24 |     box-sizing: @value;
25 | }
26 | 
27 | .text-adjust(@value) {
28 |     text-size-adjust: @value;
29 |     -ms-text-size-adjust: @value;
30 |     -webkit-text-size-adjust: @value;
31 | }
32 | 
33 | 


--------------------------------------------------------------------------------
/theme/stylesheets/ebook.less:
--------------------------------------------------------------------------------
1 | @import "./ebook/base.less";
2 | 


--------------------------------------------------------------------------------
/theme/stylesheets/ebook/base.less:
--------------------------------------------------------------------------------
 1 | @import "../base/mixins.less";
 2 | @import "./variables.less";
 3 | 
 4 | @import "./summary.less";
 5 | @import "./glossary.less";
 6 | 
 7 | body {
 8 |     font-family: @font-family-base;
 9 |     color: @text-color;
10 |     .text-adjust(100%);
11 | }
12 | 
13 | .page {
14 |     // Section and first titles
15 |     .section {
16 |         .gitbook-markdown(@md-color: @text-color, @md-line-height: 1.6, @md-link-color: @link-color);
17 |     }
18 | 
19 |     // Hide the title (only used to build PDF table of content)
20 |     .book-chapter {
21 |         display: none;
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/theme/stylesheets/ebook/glossary.less:
--------------------------------------------------------------------------------
 1 | .section.glossary {
 2 |     > h1 {
 3 |         text-align: center;
 4 |     }
 5 | 
 6 |     .glossary-entry {
 7 |         margin-bottom: 40px;
 8 | 
 9 |         h2 {
10 |             a, a:hover {
11 |                 color: inherit;
12 |                 text-decoration: none;
13 |             }
14 |         }
15 | 
16 |         .glossary-index {
17 |             list-style: none;
18 |             margin: 0px;
19 |             padding: 0px;
20 | 
21 |             li {
22 |                 display: inline;
23 |                 margin: 0px 8px;
24 |                 white-space: nowrap;
25 |             }
26 |         }
27 |     }
28 | }
29 | 


--------------------------------------------------------------------------------
/theme/stylesheets/ebook/summary.less:
--------------------------------------------------------------------------------
 1 | .section.toc {
 2 |     > h1 {
 3 |         text-align: center;
 4 |     }
 5 | 
 6 |     > ol {
 7 |         margin: 0px;
 8 |         padding: 0px;
 9 |     }
10 | 
11 |     li {
12 |         list-style: none;
13 | 
14 |         .inner {
15 |             display: block;
16 |             border-bottom: 1px dotted #eee;
17 |             margin-bottom: 4px;
18 | 
19 |             a, span {
20 |                 padding-right: 5px;
21 |                 border-bottom: 1px solid #fff;
22 |                 margin-bottom: -1px;
23 |             }
24 | 
25 |             .page {
26 |                 float: right;
27 |                 padding-left: 5px;
28 |             }
29 |         }
30 | 
31 |         ol {
32 |             margin: 0px;
33 |             padding: 0px;
34 |             padding-left: 2em;
35 |         }
36 |     }
37 | }
38 | 
39 | // For LTR, fix direction of table of content
40 | .dir-rtl {
41 |     .section.toc {
42 |         li {
43 |             .inner {
44 |                 .page {
45 |                     float: left;
46 |                 }
47 |             }
48 | 
49 |             ol {
50 |                 margin: 0px;
51 |                 padding: 0px;
52 |                 padding-right: 2em;
53 |             }
54 |         }
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/theme/stylesheets/ebook/variables.less:
--------------------------------------------------------------------------------
1 | @font-size-base:    13px;
2 | @font-family-base:  sans-serif;
3 | 
4 | @text-color:        #000;
5 | @link-color:        #4183c4;
6 | 


--------------------------------------------------------------------------------
/theme/stylesheets/epub.less:
--------------------------------------------------------------------------------
1 | @import "./ebook/base.less";
2 | 
3 | @font-family-base: serif;
4 | 


--------------------------------------------------------------------------------
/theme/stylesheets/mobi.less:
--------------------------------------------------------------------------------
 1 | @import "./ebook/base.less";
 2 | 
 3 | @font-family-base: serif;
 4 | @link-color: #000;
 5 | 
 6 | a {
 7 |     color: #000;
 8 |     text-decoration: underline !important;
 9 | }
10 | 
11 | .page-toc {
12 |     li {
13 |         list-style-type: lower-alpha;
14 | 
15 |         .inner {
16 |             border: none;
17 | 
18 |             span.page {
19 |                 display: none;
20 |             }
21 |         }
22 |     }
23 | }
24 | 


--------------------------------------------------------------------------------
/theme/stylesheets/pdf.less:
--------------------------------------------------------------------------------
 1 | @import "./ebook/base.less";
 2 | 
 3 | .pdf-footer {
 4 |     margin-top: 20px;
 5 |     padding-top: 10px;
 6 |     border-top: 1px solid #eee;
 7 |     color:#aaa;
 8 | 
 9 |     .footer-pages-count {
10 |         float: right;
11 |     }
12 | }
13 | 
14 | .pdf-header {
15 |     margin-top: 20px;
16 |     padding-bottom: 10px;
17 |     border-bottom: 1px solid #eee;
18 |     color: #aaa;
19 | }
20 | 
21 | 


--------------------------------------------------------------------------------
/theme/stylesheets/website.less:
--------------------------------------------------------------------------------
 1 | @import "base/normalize.less";
 2 | @import "base/preboot.less";
 3 | @import "base/mixins.less";
 4 | @import "../../node_modules/font-awesome/less/font-awesome.less";
 5 | 
 6 | 
 7 | @import "website/variables.less";
 8 | @import "website/languages.less";
 9 | @import "website/header.less";
10 | @import "website/dropdown.less";
11 | @import "website/alerts.less";
12 | @import "website/summary.less";
13 | @import "website/body.less";
14 | @import "website/buttons.less";
15 | @import "website/markup.less";
16 | @import "website/navigation.less";
17 | @import "website/glossary.less";
18 | 
19 | * {
20 |     .box-sizing(border-box);
21 |     -webkit-overflow-scrolling: touch;
22 |     -webkit-tap-highlight-color: transparent;
23 |     -webkit-text-size-adjust: none;
24 |     -webkit-touch-callout: none;
25 |     -webkit-font-smoothing: antialiased;
26 | }
27 | 
28 | a {
29 |     text-decoration: none;
30 | }
31 | 
32 | html, body {
33 |     height: 100%;
34 | }
35 | 
36 | html {
37 |     font-size: 62.5%;
38 | }
39 | 
40 | body {
41 |     text-rendering: optimizeLegibility;
42 |     font-smoothing: antialiased;
43 |     font-family: @font-family-base;
44 |     font-size: @font-size-base;
45 |     letter-spacing: .2px;
46 |     .text-adjust(100%);
47 | }
48 | 


--------------------------------------------------------------------------------
/theme/stylesheets/website/alerts.less:
--------------------------------------------------------------------------------
 1 | .alert {
 2 |     padding: 15px;
 3 |     margin-bottom: 20px;
 4 |     color: #444;
 5 |     background: #eee;
 6 |     border-bottom: 5px solid #ddd;
 7 | }
 8 | 
 9 | .alert-success {
10 |     background: @state-success-bg;
11 |     border-color: @state-success-border;
12 |     color: @state-success-text;
13 | }
14 | 
15 | .alert-info {
16 |     background: @state-info-bg;
17 |     border-color: @state-info-border;
18 |     color: @state-info-text;
19 | }
20 | 
21 | .alert-danger {
22 |     background: @state-danger-bg;
23 |     border-color: @state-danger-border;
24 |     color: @state-danger-text;
25 | }
26 | 
27 | .alert-warning {
28 |     background: @state-warning-bg;
29 |     border-color: @state-warning-border;
30 |     color: @state-warning-text;
31 | }
32 | 


--------------------------------------------------------------------------------
/theme/stylesheets/website/body.less:
--------------------------------------------------------------------------------
 1 | .book {
 2 |     position: relative;
 3 |     width: 100%;
 4 |     height: 100%;
 5 | 
 6 |     .book-body {
 7 |         position: absolute;
 8 |         top: 0px;
 9 |         right: 0px;
10 |         left: 0px;
11 |         bottom: 0px;
12 |         overflow-y: auto;
13 | 
14 |         color: @page-color;
15 |         background: @body-background;
16 |         .transition(left @sidebar-transition-duration ease);
17 | 
18 |         .body-inner {
19 |             position: absolute;
20 |             top: 0px;
21 |             right: 0px;
22 |             left: 0px;
23 |             bottom: 0px;
24 |             overflow-y: auto;
25 |         }
26 | 
27 |         .page-wrapper {
28 |             position: relative;
29 |             outline: none;
30 | 
31 |             .page-inner {
32 |                 max-width: 800px;
33 |                 margin: 0px auto;
34 |                 padding: 20px 0px 40px 0px;
35 | 
36 |                 section {
37 |                     margin: 0px 0px;
38 |                     padding: 5px 15px;
39 | 
40 |                     background: @page-background;
41 |                     border-radius: 2px;
42 |                     line-height: @content-line-height;
43 |                     font-size: @default-font-size;
44 |                 }
45 | 
46 |                 .btn-group {
47 |                     .btn {
48 |                         border-radius: 0px;
49 |                         background: #eee;
50 |                         border: 0px;
51 |                     }
52 |                 }
53 |             }
54 |         }
55 | 
56 |         @media (max-width: @mobileMaxWidth) {
57 |             .transition-transform(@sidebar-transition-duration ease);
58 |             padding-bottom: 20px;
59 | 
60 |             .body-inner {
61 |                 position: static;
62 |                 min-height: calc(~"100% - 50px")
63 |             }
64 |         }
65 |     }
66 | 
67 |     &.with-summary {
68 |         @media (min-width: @sidebar-breakpoint) {
69 |             .book-body {
70 |                 left: @sidebar-width;
71 |             }
72 |         }
73 |         @media (max-width: @sidebar-breakpoint) {
74 |             overflow: hidden;
75 | 
76 |             .book-body {
77 |                 .translate(~"calc(100% - 60px)", 0px);
78 |             }
79 |         }
80 |     }
81 | 
82 |     &.without-animation {
83 |         .book-body {
84 |             .transition(none) !important;
85 |         }
86 |     }
87 | }


--------------------------------------------------------------------------------
/theme/stylesheets/website/buttons.less:
--------------------------------------------------------------------------------
 1 | .buttons {
 2 |     .clearfix();
 3 | }
 4 | 
 5 | .button {
 6 |     border: 0;
 7 |     background-color: transparent;
 8 |     background: @button-background;
 9 |     color: @button-color;
10 |     width: 100%;
11 |     text-align: center;
12 |     float: left;
13 |     line-height: @line-height-base;
14 |     padding: 8px 4px;
15 | 
16 |     &:hover {
17 |         color: @button-hover-color;
18 |     }
19 | 
20 |     &:focus, &:hover {
21 |         outline: none;
22 |     }
23 | 
24 |     &.size-2 {
25 |         width: 50%;
26 |     }
27 | 
28 |     &.size-3 {
29 |         width: 33%;
30 |     }
31 | }
32 | 
33 | 


--------------------------------------------------------------------------------
/theme/stylesheets/website/dropdown.less:
--------------------------------------------------------------------------------
  1 | .dropdown {
  2 |     position: relative;
  3 | }
  4 | 
  5 | .dropdown-menu {
  6 |     position: absolute;
  7 |     top: 100%;
  8 |     left: 0;
  9 |     z-index: @dropdown-zindex;
 10 |     display: none; // none by default, but block on "open" of the menu
 11 |     float: left;
 12 |     min-width: 160px;
 13 |     padding: 0;
 14 |     margin: 2px 0 0; // override default ul
 15 |     list-style: none;
 16 |     font-size: @font-size-base;
 17 |     background-color: @dropdown-background;
 18 |     border: 1px solid @dropdown-border-color;
 19 |     border-radius: @border-radius-base;
 20 |     .box-shadow(0 6px 12px rgba(0,0,0,.175));
 21 |     background-clip: padding-box;
 22 | 
 23 |     &.open{
 24 |         display:block;
 25 |     }
 26 | 
 27 |     &.dropdown-left {
 28 |         left: auto;
 29 |         right: 4%;
 30 | 
 31 |         .dropdown-caret {
 32 |             right: 14px;
 33 |             left: auto;
 34 |         }
 35 |     }
 36 | 
 37 |     .dropdown-caret{
 38 |         position: absolute;
 39 |         top: -8px;
 40 |         left: 14px;
 41 |         width: 18px;
 42 |         height: 10px;
 43 |         float: left;
 44 |         overflow: hidden;
 45 | 
 46 |         .caret-outer{
 47 |             position: absolute;
 48 |             border-left: 9px solid transparent;
 49 |             border-right: 9px solid transparent;
 50 |             border-bottom: 9px solid rgba(0,0,0,0.1);
 51 |             height: auto;
 52 |             left: 0;
 53 |             top: 0;
 54 |             width: auto;
 55 |             display: inline-block;
 56 |             margin-left: -1px;
 57 |         }
 58 |         .caret-inner{
 59 |             position: absolute;
 60 |             display: inline-block;
 61 |             margin-top: -1px;
 62 |             top: 0;
 63 |             top: 1px;
 64 |             border-left: 9px solid transparent;
 65 |             border-right: 9px solid transparent;
 66 |             border-bottom: 9px solid @dropdown-background;
 67 |         }
 68 |     }
 69 | 
 70 |     .buttons {
 71 |         .clearfix();
 72 |         border-bottom: 1px solid @sidebar-divider-color;
 73 | 
 74 |         &:last-child {
 75 |             border-bottom: none;
 76 |         }
 77 | 
 78 |         .button {
 79 |             border: 0;
 80 |             background-color: transparent;
 81 |             color: @dropdown-button-color;
 82 |             width: 100%;
 83 |             text-align: center;
 84 |             float: left;
 85 |             line-height: @line-height-base;
 86 |             padding: 8px 4px;
 87 | 
 88 |             &:hover {
 89 |                 color: @dropdown-button-hover-color;
 90 |             }
 91 | 
 92 |             &:focus, &:hover {
 93 |                 outline: none;
 94 |             }
 95 | 
 96 |             &.size-2 {
 97 |                 width: 50%;
 98 |             }
 99 | 
100 |             &.size-3 {
101 |                 width: 33%;
102 |             }
103 |         }
104 |     }
105 | }
106 | 


--------------------------------------------------------------------------------
/theme/stylesheets/website/glossary.less:
--------------------------------------------------------------------------------
 1 | .book .book-body .page-wrapper .page-inner section.glossary {
 2 |     margin-bottom: 40px;
 3 | 
 4 |     h2 {
 5 |         a, a:hover {
 6 |             color: inherit;
 7 |             text-decoration: none;
 8 |         }
 9 |     }
10 | 
11 |     .glossary-index {
12 |         list-style: none;
13 |         margin: 0px;
14 |         padding: 0px;
15 | 
16 |         li {
17 |             display: inline;
18 |             margin: 0px 8px;
19 |             white-space: nowrap;
20 |         }
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/theme/stylesheets/website/header.less:
--------------------------------------------------------------------------------
 1 | .book {
 2 |     .book-header {
 3 |         font-family: @font-family-sans;
 4 | 
 5 |         overflow: visible;
 6 |         height: @header-height;
 7 |         padding: 0px 8px;
 8 |         z-index: 2;
 9 | 
10 |         font-size: 0.85em;
11 |         color: @header-color;
12 |         background: @header-background;
13 | 
14 |         .btn {
15 |             display: block;
16 |             height: @header-height;
17 |             padding: 0px 15px;
18 |             border-bottom: none;
19 |             color: @header-button-color;
20 |             text-transform: uppercase;
21 |             line-height: @header-height;
22 |             .box-shadow(none) !important;
23 |             position:relative;
24 |             font-size: @font-size-base;
25 | 
26 |             &:hover {
27 |                 position: relative;
28 |                 text-decoration: none;
29 |                 color: @header-button-hover-color;
30 |                 background: @header-button-hover-background;
31 |             }
32 |         }
33 | 
34 |         h1 {
35 |             margin: 0px;
36 |             font-size: 20px;
37 |             font-weight: 200;
38 |             text-align: center;
39 |             line-height: @header-height;
40 |             opacity: 0;
41 |             .transition(opacity ease 0.4s);
42 | 
43 |             padding-left: 200px;
44 |             padding-right: 200px;
45 |             .transition(opacity 0.2s ease);
46 | 
47 |             overflow: hidden;
48 |             text-overflow: ellipsis;
49 |             white-space: nowrap;
50 | 
51 |             a, a:hover {
52 |                 color: inherit;
53 |                 text-decoration: none;
54 |             }
55 | 
56 |             @media (max-width: 1000px) {
57 |                 display: none;
58 |             }
59 | 
60 |             i {
61 |                 display: none;
62 |             }
63 |         }
64 | 
65 |         &:hover {
66 |             h1 {
67 |                 opacity: 1;
68 |             }
69 |         }
70 |     }
71 | 
72 |     &.is-loading {
73 |         .book-header h1 {
74 |             i {
75 |                 display: inline-block;
76 |             }
77 |             a {
78 |                 display: none;
79 |             }
80 |         }
81 |     }
82 | }
83 | 


--------------------------------------------------------------------------------
/theme/stylesheets/website/languages.less:
--------------------------------------------------------------------------------
 1 | .book-langs-index {
 2 |     width: 100%;
 3 |     height: 100%;
 4 |     padding: 40px 0px;
 5 |     margin: 0px;
 6 |     overflow: auto;
 7 | 
 8 |     @media (max-width: 600px) {
 9 |         padding: 0px;
10 |     } 
11 | 
12 |     .inner {
13 |         max-width: 600px;
14 |         width: 100%;
15 | 
16 |         margin: 0px auto;
17 |         padding: 30px;
18 | 
19 |         background: #fff;
20 |         border-radius: 3px;
21 | 
22 |         h3 {
23 |             margin: 0px;
24 |         }
25 | 
26 |         .languages {
27 |             list-style: none;
28 |             padding: 20px 30px;
29 |             margin-top: 20px;
30 |             border-top: 1px solid #eee;
31 | 
32 |             .clearfix();
33 | 
34 |             li {
35 |                 width: 50%;
36 |                 float: left;
37 |                 padding: 10px 5px;
38 |                 font-size: 16px;
39 | 
40 |                 a {
41 | 
42 |                 }
43 | 
44 |                 @media (max-width: 600px) {
45 |                     width: 100%;
46 |                     max-width: 100%;
47 |                 } 
48 |             }
49 |         }
50 |     }
51 | }


--------------------------------------------------------------------------------
/theme/stylesheets/website/markup.less:
--------------------------------------------------------------------------------
 1 | .book .book-body .page-wrapper .page-inner section {
 2 |     display: none;
 3 | }
 4 | 
 5 | .book .book-body .page-wrapper .page-inner section.normal {
 6 |     .gitbook-markdown(@md-color: @content-color, @md-line-height: @content-line-height);
 7 | 
 8 |     .glossary-term {
 9 |         cursor: help;
10 |         text-decoration: underline;
11 |     }
12 | }
13 | 


--------------------------------------------------------------------------------
/theme/stylesheets/website/navigation.less:
--------------------------------------------------------------------------------
 1 | .book .book-body  {
 2 |     .navigation {
 3 |         position: absolute;
 4 |         top: @header-height;
 5 |         bottom: 0px;
 6 |         margin: 0;
 7 |         max-width: 150px;
 8 |         min-width: 90px;
 9 | 
10 |         display: flex;
11 |         justify-content: center;
12 |         align-content: center;
13 |         flex-direction: column;
14 | 
15 |         font-size: 40px;
16 |         color: @navigation-color;
17 | 
18 |         text-align: center;
19 | 
20 |         .transition(all 350ms ease);
21 | 
22 |         &:hover {
23 |             text-decoration: none;
24 |             color: @navigation-hover-color;
25 |         }
26 | 
27 |         &.navigation-next {
28 |             right: 0px;
29 |         }
30 |         &.navigation-prev {
31 |             left: 0px;
32 |         }
33 |     }
34 | 
35 |     @media (max-width: @mobileMaxWidth) {
36 |         .navigation {
37 |             position: static;
38 |             top: auto;
39 |             max-width: 50%;
40 |             width: 50%;
41 |             display: inline-block;
42 |             float: left;
43 | 
44 |             &.navigation-unique {
45 |                 max-width: 100%;
46 |                 width: 100%;
47 |             }
48 |         }
49 |     }
50 | }
51 | 


--------------------------------------------------------------------------------
/theme/stylesheets/website/summary.less:
--------------------------------------------------------------------------------
  1 | .book {
  2 |     .book-summary {
  3 |         font-family: @font-family-sans;
  4 | 
  5 |         position: absolute;
  6 |         top: 0px;
  7 |         left: -@sidebar-width;
  8 |         bottom: 0px;
  9 |         z-index: 1;
 10 | 
 11 |         width: @sidebar-width;
 12 |         color: @sidebar-color;
 13 |         background: @sidebar-background;
 14 |         border-right: @sidebar-border-right;
 15 | 
 16 |         .transition(left @sidebar-transition-duration ease);
 17 | 
 18 |         ul.summary {
 19 |             position: absolute;
 20 |             top: 0px;
 21 |             left: 0px;
 22 |             right: 0px;
 23 |             bottom: 0px;
 24 | 
 25 |             overflow-y: auto;
 26 | 
 27 |             list-style: none;
 28 |             margin: 0px;
 29 |             padding: 0px;
 30 | 
 31 |             .transition(top 0.5s ease);
 32 | 
 33 |             li {
 34 |                 list-style: none;
 35 | 
 36 |                 &.divider {
 37 |                     height: 1px;
 38 |                     margin: 7px 0;
 39 |                     overflow: hidden;
 40 |                     background: @sidebar-divider-color;
 41 |                 }
 42 | 
 43 |                 i.fa-check {
 44 |                     display: none;
 45 |                     position: absolute;
 46 |                     right: 9px;
 47 |                     top: 16px;
 48 |                     font-size: 9px;
 49 |                     color: @sidebar-icon-color;
 50 |                 }
 51 | 
 52 |                 &.done {
 53 |                     > a {
 54 |                         color: @sidebar-link-completed;
 55 |                         font-weight: @sidebar-link-completed-weight;
 56 | 
 57 |                         i {
 58 |                             display: inline;
 59 |                         }
 60 |                     }
 61 |                 }
 62 | 
 63 |                 a, span {
 64 |                     display: block;
 65 |                     padding: 10px 15px;
 66 |                     border-bottom: none;
 67 |                     color: @sidebar-link-color;
 68 |                     background: @sidebar-link-background;
 69 |                     text-overflow: ellipsis;
 70 |                     overflow: hidden;
 71 |                     white-space: nowrap;
 72 |                     position: relative;
 73 |                 }
 74 | 
 75 |                 span {
 76 |                     cursor: not-allowed;
 77 |                     .opacity(0.3);
 78 |                 }
 79 | 
 80 |                 &.active > a, a:hover {
 81 |                     color: @sidebar-link-hover-color;
 82 |                     background: @sidebar-link-hover-background;
 83 |                     text-decoration: none;
 84 |                 }
 85 | 
 86 |                 ul {
 87 |                     padding-left: @sidebar-nested-padding;
 88 |                 }
 89 |             }
 90 |         }
 91 | 
 92 |         @media (max-width: @sidebar-breakpoint) {
 93 |             width: calc(~"100% - 60px");
 94 |             bottom: 0px;
 95 |             left: -100%;
 96 |         }
 97 |     }
 98 | 
 99 |     &.with-summary {
100 |         .book-summary {
101 |             left: 0px;
102 |         }
103 |     }
104 | 
105 |     &.without-animation {
106 |         .book-summary {
107 |             .transition(none) !important;
108 |         }
109 |     }
110 | }
111 | 


--------------------------------------------------------------------------------
/theme/stylesheets/website/variables.less:
--------------------------------------------------------------------------------
  1 | @staticPath: ".";
  2 | 
  3 | // Font sizes
  4 | @font-size-base:          14px;
  5 | @font-size-large:         ceil(@font-size-base * 1.25); // ~18px
  6 | @font-size-small:         ceil(@font-size-base * 0.85); // ~12px
  7 | @line-height-base:        1.428571429; // 20/14
  8 | @line-height-computed:    floor(@font-size-base * @line-height-base);
  9 | 
 10 | // Sizes
 11 | @mobileMaxWidth:                      1240px;
 12 | 
 13 | // Header
 14 | @header-height:                       50px;
 15 | @header-color:                        hsl(194, 5%, 52%);
 16 | @header-background:                   transparent;
 17 | @header-border:                       rgba(0, 0, 0, 0.07);
 18 | @header-button-color:                 #ccc;
 19 | @header-button-hover-color:           #444;
 20 | @header-button-hover-background:      none;
 21 | 
 22 | // Navigation
 23 | @navigation-color:                    @header-button-color;
 24 | @navigation-hover-color:              @header-button-hover-color;
 25 | 
 26 | // Body
 27 | @body-background:                     white;
 28 | 
 29 | // Sidebar
 30 | @sidebar-transition-duration:         250ms;
 31 | @sidebar-width:                       300px;
 32 | @sidebar-breakpoint:                  600px;
 33 | @sidebar-color:                       hsl(207, 15%, 25%);
 34 | @sidebar-background:                  #fafafa;
 35 | @sidebar-border-right:                1px solid @header-border;
 36 | 
 37 | @sidebar-nested-padding:              20px;
 38 | @sidebar-divider-color:               @header-border;
 39 | 
 40 | @sidebar-link-color:                  @sidebar-color;
 41 | @sidebar-link-background:             transparent;
 42 | @sidebar-link-hover-color:            hsl(207, 100%, 50%);
 43 | @sidebar-link-hover-background:       transparent;
 44 | 
 45 | @sidebar-icon-color:                  hsl(120, 60%, 50%);
 46 | @sidebar-link-completed:              @sidebar-link-color;
 47 | @sidebar-link-completed-weight:       normal;
 48 | 
 49 | // Page
 50 | @page-color:                          black;
 51 | @page-background:                     @body-background;
 52 | 
 53 | // Content
 54 | @content-line-height:                 1.7;
 55 | @content-color:                       #333333;
 56 | 
 57 | // Dropdown
 58 | @dropdown-zindex:                     100;
 59 | @dropdown-divider-color:              @sidebar-divider-color;
 60 | @dropdown-background:                 @sidebar-background;
 61 | @dropdown-button-color:               darken(@header-button-color, 15%);
 62 | @dropdown-border-color:               @sidebar-divider-color;
 63 | @dropdown-button-hover-color:         @header-button-hover-color;
 64 | 
 65 | // Buttons
 66 | @button-background:                   #eee;
 67 | @button-color:                        #666;
 68 | @button-hover-color:                  #444;
 69 | 
 70 | // States and alerts
 71 | @state-success-text:                  #3c763d;
 72 | @state-success-bg:                    #dff0d8;
 73 | @state-success-border:                darken(spin(@state-success-bg, -10), 5%);
 74 | 
 75 | @state-info-text:                     #31708f;
 76 | @state-info-bg:                       #d9edf7;
 77 | @state-info-border:                   darken(spin(@state-info-bg, -10), 7%);
 78 | 
 79 | @state-warning-text:                  #8a6d3b;
 80 | @state-warning-bg:                    #fcf8e3;
 81 | @state-warning-border:                darken(spin(@state-warning-bg, -10), 5%);
 82 | 
 83 | @state-danger-text:                   #a94442;
 84 | @state-danger-bg:                     #f2dede;
 85 | @state-danger-border:                 darken(spin(@state-danger-bg, -10), 5%);
 86 | 
 87 | // Border Radius
 88 | @border-radius-base:                  1px;
 89 | @border-radius-large:                 3px;
 90 | @border-radius-small:                 1px;
 91 | 
 92 | // Fonts
 93 | @font-family-serif:                   Georgia, serif;
 94 | @font-family-sans:                    "Helvetica Neue", Helvetica, Arial, sans-serif;
 95 | @font-family-base:                    @font-family-sans;
 96 | @headings-font-family:                inherit;
 97 | 
 98 | @FontPath:                            '@{staticPath}/fonts';
 99 | @fa-font-path:                        "@{FontPath}/fontawesome";
100 | 
101 | @s-font-size:                         1.2rem;
102 | @m-font-size:                         1.4rem;
103 | @l-font-size:                         1.6rem;
104 | @xl-font-size:                        2.2rem;
105 | @xxl-font-size:                       4.0rem;
106 | @default-font-size:                   @l-font-size;
107 | 
108 | 


--------------------------------------------------------------------------------
/theme/templates/ebook/footer.html:
--------------------------------------------------------------------------------
1 | <html>
2 |     <body>
3 |         <div class="pdf-footer">
4 |             <span>_SECTION_</span>
5 |             <span class="footer-pages-count">_PAGENUM_</span>
6 |         </div>
7 |     </body>
8 | </html>


--------------------------------------------------------------------------------
/theme/templates/ebook/glossary.html:
--------------------------------------------------------------------------------
 1 | {% extends "./page.html" %}
 2 | 
 3 | {% block title %}{{ __("GLOSSARY") }} | {{ title }}{% endblock %}
 4 | 
 5 | {% block page %}
 6 |     <h1 class="book-chapter book-chapter-1">{{ __("GLOSSARY") }}</h1>
 7 |     <div class="section glossary">
 8 |         <h1>{{ __("GLOSSARY") }}</h1>
 9 | 
10 |         {% for item in glossary %}
11 |         <div class="glossary-entry" id="{{ item.id }}">
12 |             <h2><a href="#{{ item.id }}">{{ item.name }}</a></h2>
13 |             <p>{{ item.description|safe }}</p>
14 |             <ul class="glossary-index">
15 |             {% for file in item.files %}
16 |                 <li><a href="{{ basePath }}/{{ file.path|contentLink }}"><span class="level">{{ file.level }}.</span> {{ file.title }}</a></li>
17 |             {% endfor %}
18 |             </ul>
19 |         </div>
20 |         {% endfor %}
21 |     </div>
22 | {% endblock %}
23 | 


--------------------------------------------------------------------------------
/theme/templates/ebook/header.html:
--------------------------------------------------------------------------------
1 | <html>
2 |     <body>
3 |         <div class="pdf-header">
4 |             <span>_TITLE_</span>
5 |         </div>
6 |     </body>
7 | </html>


--------------------------------------------------------------------------------
/theme/templates/ebook/layout.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE HTML>
 2 | <html lang="{{ language }}" {% block htmlTag %}{% endblock %} {% if options.direction == "rtl" %}dir="rtl"{% endif %}>
 3 |     {{ htmlSnippet("html:start")|default("", true)|safe }}
 4 |     <head>
 5 |         {{ htmlSnippet("head:start")|default("", true)|safe }}
 6 |         <meta charset="UTF-8">
 7 |         <title>{% block title %}{% endblock %}</title>
 8 |         <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
 9 |         <meta name="description" content="{% block description %}{% endblock %}">
10 |         <meta name="generator" content="GitBook {{ gitbook.version }}">
11 |         {% if options.author %}<meta name="author" content="{{ options.author }}">{% endif %}
12 |         {% if options.isbn %}<meta name="identifier" content="{{ options.isbn }}" scheme="ISBN">{% endif %}
13 |         {% block head %}{% endblock %}
14 |         {% block style %}{% endblock %}
15 |         {{ htmlSnippet("head:end")|default("", true)|safe }}
16 |     </head>
17 |     <body class="dir-{{ options.direction }}">
18 |         {{ htmlSnippet("body:start")|default("", true)|safe }}
19 |         {% block content %}{% endblock %}
20 |         {% block javascript %}{% endblock %}
21 |         {{ htmlSnippet("body:end")|default("", true)|safe }}
22 |     </body>
23 |     {{ htmlSnippet("html:end")|default("", true)|safe }}
24 | </html>
25 | 


--------------------------------------------------------------------------------
/theme/templates/ebook/page.html:
--------------------------------------------------------------------------------
 1 | {% extends "./layout.html" %}
 2 | 
 3 | {% block title %}{{ progress.current.title }} | {{ title }}{% endblock %}
 4 | 
 5 | {% block style %}
 6 |     {# Default styles if not disabled #}
 7 |     {% if not styles.print %}
 8 |         <link rel="stylesheet" href="{{ staticBase }}/{{ options.generator }}.css">
 9 |     {% endif %}
10 | 
11 |     {# Style from plugins  #}
12 |     {% for resource in plugins.resources.css %}
13 |         {% if resource.url %}
14 |         <link rel="stylesheet" href="{{ resource.url }}">
15 |         {% else %}
16 |         <link rel="stylesheet" href="{{ staticBase }}/plugins/{{ resource.path }}">
17 |         {% endif %}
18 |     {% endfor %}
19 | 
20 |     {# Custom styles from the book #}
21 |     {% for type, style in styles %}
22 |         <link rel="stylesheet" href="{{ basePath }}/{{ style }}">
23 |     {% endfor %}
24 | {% endblock %}
25 | 
26 | {% block content %}
27 | <div class="page">
28 |     {% block page %}
29 |         <h1 class="book-chapter book-chapter-{{ progress.current.level|lvl }}">{{ progress.current.title }}</h1>
30 |         {% for section in content %}
31 |             <div class="section {{ section.type }}" id="section-{{ section.id }}">
32 |             {% if section.type == "normal" %}
33 |                 {% autoescape false %}{{ section.content }}{% endautoescape %}
34 |             {% endif %}
35 |             </div>
36 |         {% endfor %}
37 |     {% endblock %}
38 | </div>
39 | {% endblock %}
40 | 
41 | 


--------------------------------------------------------------------------------
/theme/templates/ebook/summary.html:
--------------------------------------------------------------------------------
 1 | {% extends "./page.html" %}
 2 | 
 3 | {% block title %}{{ __("SUMMARY") }} | {{ title }}{% endblock %}
 4 | 
 5 | {% macro articles(_articles) %}
 6 |     {% for item in _articles %}
 7 |         <li>
 8 |             <span class="inner">
 9 |                 {% if item.path and item.exists %}
10 |                     {% if not item.external %}
11 |                         <a href="{{ basePath }}/{{ item.path|contentLink }}">{{ item.title }}</a>
12 |                     {% else %}
13 |                         <a target="_blank" href="{{ item.path }}">{{ item.title }}</a>
14 |                     {% endif %}
15 |                 {% else %}
16 |                     <span>{{ item.title }}</span>
17 |                 {% endif %}
18 |                 {% if options.generator != "mobi" %}
19 |                 <span class="page">{{ item.level }}</span>
20 |                 {% endif %}
21 |             </span>
22 |             {% if item.articles.length > 0 %}
23 |             <ol>
24 |                 {{ articles(item.articles) }}
25 |             </ol>
26 |             {% endif %}
27 |         </li>
28 |     {% endfor %}
29 | {% endmacro %}
30 | 
31 | {% block page %}
32 | <div class="section toc">
33 |     <h1>{{ __("SUMMARY") }}</h1>
34 |     <ol>
35 |         {{ articles(summary.chapters) }}
36 | 
37 |         {% if glossary.length > 0 %}
38 |         <li>
39 |             <span class="inner">
40 |                 <a href="{{ basePath }}/GLOSSARY.html">{{ __("GLOSSARY") }}</a>
41 |             </span>
42 |         </li>
43 |         {% endif %}
44 |     </ol>
45 | </div>
46 | {% endblock %}
47 | 
48 | 


--------------------------------------------------------------------------------
/theme/templates/website/glossary.html:
--------------------------------------------------------------------------------
 1 | {% extends "page.html" %}
 2 | 
 3 | {% block title %}{{ __("GLOSSARY") }} | {{ title }}{% endblock %}
 4 | 
 5 | {% block page_inner %}
 6 |     {% for item in glossary %}
 7 |     <section class="normal glossary" id="{{ item.id }}">
 8 |         <h2><a href="#{{ item.id }}">{{ item.name }}</a></h2>
 9 |         <p>{{ item.description|safe }}</p>
10 |         <ul class="glossary-index">
11 |         {% for file in item.files %}
12 |             <li><a href="{{ basePath }}/{{ file.path|contentLink }}"><span class="level">{{ file.level }}.</span> {{ file.title }}</a></li>
13 |         {% endfor %}
14 |         </ul>
15 |     </section>
16 |     {% endfor %}
17 | {% endblock %}
18 | 


--------------------------------------------------------------------------------
/theme/templates/website/includes/header.html:
--------------------------------------------------------------------------------
 1 | <div class="book-header" role="navigation">
 2 |     <!-- Actions Left -->
 3 |     {% if glossary.length > 0 %}
 4 |     <a href="{{ basePath }}/GLOSSARY.html" class="btn pull-left" aria-label="{{ __("GLOSSARY_OPEN") }}"><i class="fa fa-sort-alpha-asc"></i></a>
 5 |     {% endif %}
 6 | 
 7 |     <!-- Title -->
 8 |     <h1>
 9 |         <i class="fa fa-circle-o-notch fa-spin"></i>
10 |         <a href="{{ basePath }}/" >{{ title }}</a>
11 |     </h1>
12 | </div>
13 | 


--------------------------------------------------------------------------------
/theme/templates/website/includes/summary.html:
--------------------------------------------------------------------------------
 1 | {% macro articles(_articles) %}
 2 |     {% for item in _articles %}
 3 |         <li class="chapter {% if item.path == _input %}active{% endif %}" data-level="{{ item.level }}" {% if item.path and not item.external %}data-path="{{ item.path|contentLink }}"{% endif %}>
 4 |             {% if item.path and item.exists %}
 5 |                 {% if not item.external %}
 6 |                     <a href="{{ basePath }}/{{ item.path|contentLink }}">
 7 |                 {% else %}
 8 |                     <a target="_blank" href="{{ item.path }}">
 9 |                 {% endif %}
10 |                         <i class="fa fa-check"></i>
11 |                         {% if item.level != "0" %}
12 |                             <b>{{ item.level }}.</b>
13 |                         {% endif %}
14 |                         {{ item.title }}
15 |                     </a>
16 |             {% else %}
17 |             <span><b>{{ item.level }}.</b> {{ item.title }}</span>
18 |             {% endif %}
19 |             {% if item.articles.length > 0 %}
20 |             <ul class="articles">
21 |                 {{ articles(item.articles) }}
22 |             </ul>
23 |             {% endif %}
24 |         </li>
25 |     {% endfor %}
26 | {% endmacro %}
27 | 
28 | <div class="book-summary">
29 |     <nav role="navigation">
30 |         <ul class="summary">
31 |             {% set _divider = false %}
32 |             {% if options.links.sidebar %}
33 |             {% for linkTitle, link in options.links.sidebar %}
34 |                 {% set _divider = true %}
35 |                 <li>
36 |                     <a href="{{ link }}" target="blank" class="custom-link">{{ linkTitle }}</a>
37 |                 </li>
38 |             {% endfor %}
39 |             {% endif %}
40 | 
41 |             {% if _divider %}
42 |             <li class="divider"></li>
43 |             {% endif %}
44 | 
45 |             {{ articles(summary.chapters) }}
46 | 
47 |             {% if options.links.gitbook != false %}
48 |             <li class="divider"></li>
49 |             <li>
50 |                 <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
51 |                     {{ __("GITBOOK_LINK") }}
52 |                 </a>
53 |             </li>
54 |             {% endif %}
55 |         </ul>
56 |     </nav>
57 | </div>
58 | 


--------------------------------------------------------------------------------
/theme/templates/website/langs.html:
--------------------------------------------------------------------------------
 1 | {% extends "./layout.html" %}
 2 | 
 3 | {% block title %}{{ __("LANGS_CHOOSE") }} | {{ title }}{% endblock %}
 4 | 
 5 | {% block style %}
 6 | <link rel="stylesheet" href="{{ staticBase }}/style.css">
 7 | {% endblock %}
 8 | 
 9 | {% block content %}
10 | <div class="book-langs-index" role="navigation">
11 |     <div class="inner">
12 |         <h3>{{ __("LANGS_CHOOSE") }}</h3>
13 | 
14 |         <ul class="languages">
15 |         {%  for lang in langs %}
16 |             <li>
17 |                 <a href="{{ basePath}}/{{ lang.lang }}/index.html">{{ lang.title }}</a>
18 |             </li>
19 |         {% endfor %}
20 |         </ul>
21 |     </div>
22 | </div>
23 | {% endblock %}
24 | 
25 | {% block javascript %}{% endblock %}
26 | 


--------------------------------------------------------------------------------
/theme/templates/website/layout.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE HTML>
 2 | <html lang="{{ language }}" {% if options.direction == "rtl" %}dir="rtl"{% endif %}>
 3 |     {{ htmlSnippet("html:start")|default("", true)|safe }}
 4 |     <head>
 5 |         {{ htmlSnippet("head:start")|default("", true)|safe }}
 6 |         <meta charset="UTF-8">
 7 |         <meta http-equiv="X-UA-Compatible" content="IE=edge" />
 8 |         <title>{% block title %}{% endblock %}</title>
 9 |         <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
10 |         <meta name="description" content="{% block description %}{% endblock %}">
11 |         <meta name="generator" content="GitBook {{ gitbook.version }}">
12 |         {% if options.author %}<meta name="author" content="{{ options.author }}">{% endif %}
13 |         {% if options.isbn %}<meta name="identifier" content="{{ options.isbn }}" scheme="ISBN">{% endif %}
14 |         <meta name="HandheldFriendly" content="true"/>
15 |         <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
16 |         <meta name="apple-mobile-web-app-capable" content="yes">
17 |         <meta name="apple-mobile-web-app-status-bar-style" content="black">
18 |         <link rel="apple-touch-icon-precomposed" sizes="152x152" href="{{ staticBase }}/images/apple-touch-icon-precomposed-152.png">
19 |         <link rel="shortcut icon" href="{{ staticBase }}/images/favicon.ico" type="image/x-icon">
20 |         {% block style %}{% endblock %}
21 |         {% block head %}{% endblock %}
22 |         {{ htmlSnippet("head:end")|default("", true)|safe }}
23 |     </head>
24 |     <body>
25 |         {{ htmlSnippet("body:start")|default("", true)|safe }}
26 |         {% block content %}{% endblock %}
27 |         {% block javascript %}{% endblock %}
28 |         {{ htmlSnippet("body:end")|default("", true)|safe }}
29 |     </body>
30 |     {{ htmlSnippet("html:end")|default("", true)|safe }}
31 | </html>
32 | 


--------------------------------------------------------------------------------
/theme/templates/website/page.html:
--------------------------------------------------------------------------------
 1 | {% extends "./layout.html" %}
 2 | 
 3 | {% block head %}
 4 |     {{ super() }}
 5 |     {% if progress.current.next and progress.current.next.path %}
 6 |     <link rel="next" href="{{ basePath }}/{{ progress.current.next.path|contentLink }}" />
 7 |     {% endif %}
 8 |     {% if progress.current.prev and progress.current.prev.path %}
 9 |     <link rel="prev" href="{{ basePath }}/{{ progress.current.prev.path|contentLink }}" />
10 |     {% endif %}
11 | {% endblock %}
12 | 
13 | {% block title %}{{ progress.current.title }} | {{ title }}{% endblock %}
14 | {% block description %}{% if progress.current.level == "0" %}{{ description }}{% endif %}{% endblock %}
15 | 
16 | {% block content %}
17 |     <div class="book"
18 |         data-level="{{ progress.current.level }}"
19 |         data-chapter-title="{{ progress.current.title }}"
20 |         data-filepath="{{ progress.current.path }}"
21 |         data-basepath="{{ basePath }}"
22 |         data-revision="{{ revision }}"
23 |         data-innerlanguage="{{ innerlanguage }}">
24 |     {% include "includes/summary.html" %}
25 |     <div class="book-body">
26 |         <div class="body-inner">
27 |             {% include "includes/header.html" %}
28 |             <div class="page-wrapper" tabindex="-1" role="main">
29 |                 <div class="page-inner">
30 |                 {% block page_inner %}
31 |                 {% for section in content %}
32 |                     <section class="{{ section.type }}" id="section-{{ section.id }}">
33 |                     {% if section.type == "normal" %}
34 |                         {% autoescape false %}{{ section.content }}{% endautoescape %}
35 |                     {% endif %}
36 |                     </section>
37 |                 {% endfor %}
38 |                 {% endblock %}
39 |                 </div>
40 |             </div>
41 |         </div>
42 | 
43 |         {% if progress.current.prev and progress.current.prev.path %}
44 |         <a href="{{ basePath }}/{{ progress.current.prev.path|contentLink }}" class="navigation navigation-prev {% if not (progress.current.next and progress.current.next.path) %}navigation-unique{% endif %}" aria-label="Previous page: {{ progress.current.prev.title }}"><i class="fa fa-angle-left"></i></a>
45 |         {% endif %}
46 |         {% if progress.current.next and progress.current.next.path %}
47 |         <a href="{{ basePath }}/{{ progress.current.next.path|contentLink }}" class="navigation navigation-next {% if not (progress.current.prev or progress.current.prev.path) %}navigation-unique{% endif %}" aria-label="Next page: {{ progress.current.next.title }}"><i class="fa fa-angle-right"></i></a>
48 |         {% endif %}
49 |     </div>
50 | </div>
51 | {% endblock %}
52 | 
53 | {% block javascript %}
54 | <script src="{{ staticBase }}/app.js"></script>
55 | {% for resource in plugins.resources.js %}
56 |     {% if resource.url %}
57 |     <script src="{{ resource.url }}"></script>
58 |     {% else %}
59 |     <script src="{{ staticBase }}/plugins/{{ resource.path }}"></script>
60 |     {% endif %}
61 | {% endfor %}
62 | <script>
63 | require(["gitbook"], function(gitbook) {
64 |     var config = {% autoescape false %}{{ pluginsConfig }}{% endautoescape %};
65 |     gitbook.start(config);
66 | });
67 | </script>
68 | {% endblock %}
69 | 
70 | {% block style %}
71 |     <link rel="stylesheet" href="{{ staticBase }}/style.css">
72 |     {% for resource in plugins.resources.css %}
73 |         {% if resource.url %}
74 |         <link rel="stylesheet" href="{{ resource.url }}">
75 |         {% else %}
76 |         <link rel="stylesheet" href="{{ staticBase }}/plugins/{{ resource.path }}">
77 |         {% endif %}
78 |     {% endfor %}
79 |     {% for type, style in styles %}
80 |         <link rel="stylesheet" href="{{ basePath }}/{{ style }}">
81 |     {% endfor %}
82 | {% endblock %}
83 | 


--------------------------------------------------------------------------------